genesisdb-io-mcp-server by genesisdb-io - MCP Server

GenesisDB MCP Server (Preview)

Preview Release: This is an early version of the GenesisDB MCP Server. Features and API structure may change before the stable 1.0 release.

A Model Context Protocol (MCP) server that provides AI clients access to GenesisDB events. This server enables natural language queries against your GenesisDB instance, allowing questions like "How many users are in the system?" or "How many orders did we have last week?"

Installation

Download the MCP Server

Download GenesisDB MCP Server (Preview): macOS (Apple Silicon)

Download GenesisDB MCP Server (Preview): macOS (Intel)

Download GenesisDB MCP Server (Preview): Linux (AMD64)

Download GenesisDB MCP Server (Preview): Linux (ARM64)

Configuring with Claude Desktop

Add this server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "genesisdb": {
      "command": "/path/to/genesisdb-mcp-server",
      "env": {
        "GENESISDB_HOST": "http://localhost:8080",
        "GENESISDB_AUTH_TOKEN": "your-bearer-token"
      }
    }
  }
}

Example Queries

Once configured with an AI client, you can ask questions like:

"Wie viele Benutzer sind im System angemeldet?" (How many users are logged into the system?)
"Wie viele Bestellungen hatten wir in der Vorwoche?" (How many orders did we have last week?)
"Zeige mir alle Events für Kunde XYZ" (Show me all events for customer XYZ)
"Welche Event-Typen gibt es in der Datenbank?" (What event types exist in the database?)

Features

Query Events: Search events by type, time range, and subject pattern
Count Events: Get event counts grouped by type
List Event Types: Discover all available event types in your database
Get Events by Subject: Retrieve all events for a specific entity/subject

License

MIT

genesisdb-io/genesisdb-io-mcp-server