Kurrentdb Mcp Server

Name: Kurrentdb Mcp Server
Author: kurrent-io

@kurrent-io

Repository

About Kurrentdb Mcp Server

This is a simple MCP server to help you explore data and prototype projections faster on top of KurrentDB.

#database

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "KurrentDB": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\iamyo\\work\\mcp-server",
        "run",
        "server.py"
      ],
      "env": {
        "KURRENTDB_CONNECTION_STRING": "esdb://localhost:2113?Tls=false"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Kurrentdb Mcp Server?

Kurrentdb Mcp Server is a simple MCP server that helps you explore data and prototype projections faster on top of KurrentDB. It provides a CLI-based interface for querying stream data and managing projections, with access control handled via the KurrentDB connection string set as an environment variable.

How to use Kurrentdb Mcp Server?

Enable --run-projections=all and --start-standard-projections on KurrentDB. Then configure your MCP client (Claude Desktop, VS Code, Cursor, or Windsurf) with a JSON configuration that sets the command to uv run server.py (or python server.py) and provides the KURRENTDB_CONNECTION_STRING environment variable. Once configured, you can invoke any of the eight available tools through the client.

Key features of Kurrentdb Mcp Server

8 tool calls for streams and projections
Read events from any specific stream
List all available streams in the database
Write new events to a stream
Build, create, update, and test projections
Retrieve projection status and statistics
AI-assisted projection code generation

Use cases of Kurrentdb Mcp Server

Explore stream data interactively without manual queries
Prototype and debug KurrentDB projections quickly
Write sample events to test projection behavior
Monitor projection status and performance

FAQ from Kurrentdb Mcp Server

What are projections in KurrentDB?

Projections are computed views that process events from streams to create queryable data structures.

How is access control handled?

Access control is managed via the KurrentDB connection string provided as the KURRENTDB_CONNECTION_STRING environment variable at configuration time.

Which MCP clients are supported?

The server works with Claude Desktop, VS Code (via .vscode/mcp.json), Cursor (via .cursor/mcp.json), and Windsurf (via .codeium/windsurf/mcp_config.json).

What KurrentDB settings are required?

KurrentDB must be started with --run-projections=all and --start-standard-projections; the $streams stream is used to discover available streams.

Can I test a projection before creating it?

Yes, the test_projection tool writes test events to a projection to verify its functionality by reading the emitted streams or the projection’s state.