Quick Start

Run the Server

Teidelum serves MCP over stdio. Start it:

./target/release/teidelum

On first run, it generates demo data (team members, project tasks, incidents, and sample documents) so you can explore immediately.

Add Teidelum to your MCP client configuration. For Claude Desktop or Claude Code, add to your MCP settings:

{
  "mcpServers": {
    "teidelum": {
      "command": "/path/to/teidelum"
    }
  }
}

Replace /path/to/teidelum with the absolute path to your built binary.

Once connected, your AI agent has access to five tools:

Ask your agent: “Search for authentication docs”

This triggers the search tool, which performs full-text search with BM25 ranking across all indexed documents.

Ask: “Show me all team members”

This triggers the sql tool:

SELECT * FROM team_members

Ask: “Find all tasks assigned to Alice Chen”

This triggers the graph tool, traversing FK relationships between project_tasks and team_members.

Ask: “Describe the available data”

This triggers the describe tool, returning all tables, their schemas, and registered relationships.