KurrentDB

KurrentDB

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

10
Stars
2
Forks
0
Releases

Overview

This MCP server exposes KurrentDB stream data to MCP clients, providing a simple interface for querying and retrieving stream events and for creating, testing, and debugging projections. Access control is implemented via a KurrentDB connection string supplied as an environment variable at configuration time. The server exposes eight tools: read_stream, list_streams, write_events_to_stream, build_projection, create_projection, update_projection, test_projection, and get_projections_status. Through these tools, clients can read events from streams, enumerate available streams, write new events, and manage projections—from building AI-assisted projections to deploying, updating, testing with sample data, and inspecting status. The README outlines setup for multiple MCP clients (VS Code, Claude Desktop, Cursor, Windsurf) and demonstrates how to provide the KURRENTDB_CONNECTION_STRING in environment variables or JSON configuration. Overall, the server is designed to make stream data available to MCP clients and to support exploration, data retrieval, and iterative projection development on top of KurrentDB.

Details

Owner
kurrent-io
Language
Python
License
MIT License
Updated
2025-12-07

Features

read_stream

Reads events from a specific KurrentDB stream. Parameters: stream (required), backwards (optional, default false), limit (optional, default 10).

list_streams

Lists available streams in KurrentDB. Parameters: limit (optional, default 100), read_backwards (optional, default true).

write_events_to_stream

Writes new events to a stream. Parameters: stream (required), data (required), event_type (required), metadata (required).

build_projection

Builds a projection using AI assistance based on a user prompt.

create_projection

Creates a projection using provided code. Note: client normally asks for confirmation before creating.

update_projection

Updates an existing projection with new code.

get_projections_status

Retrieves status and statistics for a projection.

test_projection

Writes test events to a projection to verify its functionality.

Audience

DevelopersUse with MCP clients to explore data streams and prototype projections on top of KurrentDB.
Data scientistsExperiment with stream analytics and projection testing in prototyping workflows.
ML EngineersLeverage AI models to query streams and test projections.

Tags

MCPKurrentDBstreamsprojectionsread_streamlist_streamswrite_events_to_streambuild_projectioncreate_projectionupdate_projectiontest_projectionget_projections_statusaccess_control