thenativeweb/eventsourcingdb-mcp repository overview

⁠EventSourcingDB MCP Server

EventSourcingDB MCP Server is an MCP server that connects LLMs to EventSourcingDB – enabling AI-assisted exploration, querying, and management of event streams through natural language.

This image provides the official Docker distribution of the EventSourcingDB MCP Server. It is suitable for development, testing, and production deployments.

📘 Full documentation⁠

⁠Quick Start (Local Development)

Start the EventSourcingDB MCP Server in seconds using Docker:

docker run -it -p 3000:3000 \
  thenativeweb/eventsourcingdb-mcp:<VERSION> run \
  --esdb-url=<ESDB_URL> \
  --esdb-api-token=<ESDB_API_TOKEN> \
  --http-enabled \
  --https-enabled=false

Replace the placeholders:

• <VERSION>: Docker image tag to use (e.g. 1.0.0)
• <ESDB_URL>: URL of the running EventSourcingDB instance
• <ESDB_API_TOKEN>: API token of the EventSourcingDB instance

⚠️ Do not use this configuration in production.
It uses HTTP without TLS and no MCP server authentication – both insecure for real-world use.

⁠Production Deployment

To run the EventSourcingDB MCP Server securely in production, configure the container with:

• TLS encryption using your own certificate and private key
• A strong API token to authenticate MCP clients (--api-token)
• HTTP disabled to avoid unencrypted connections
• Proper restart behavior using --restart always and --init

🛠️ See the MCP server documentation⁠ for complete instructions.

⁠Key Features

• Read and write events with preconditions for consistency control
• Browse subjects and event types to explore the event store structure
• Register event schemas to enforce validation on write
• Run EventQL queries for analytical and cross-stream operations
• Built-in EventQL documentation accessible directly from the LLM
• Secure by default: HTTPS enabled, optional Bearer token authentication for MCP clients
• Runs anywhere: Linux, macOS, Windows; x86 and ARM; Docker or binary

⁠Licensing

The EventSourcingDB MCP Server is free to use without restrictions.

EventSourcingDB itself is free for small projects (up to 25,000 events). A commercial license is required for larger projects.

📄 Licensing details⁠
📬 Contact us: [email protected]⁠

⁠Need Help?

We support teams with architecture, integration, scaling, and operations.

Feel free to reach out: [email protected]⁠