dokkaiv0.1.0
MCP Server

MCP Server

A stdio MCP server that exposes dokkai's graph-aware retrieval as tools any MCP-capable agent can call directly.

Dokkai's core deliverable is a stdio MCP server (dokkai, src/mcp_server.py) that exposes the same graph-aware retrieval used by POST /chat as tools any MCP client — Claude Code, Codex, or any other — can call. Instead of grepping and reading whole files, an agent asks dokkai for exact, connected, token-lean context.

  • Transport: stdio only. There is no HTTP/SSE MCP transport, and no new HTTP endpoints ship with it.
  • Requires only Weaviate up and a project ingested (docker compose up -d + POST /instances/pipeline). The FastAPI app is not needed to use the MCP server.
  • Responses are compact plain text (not JSON), with English-only errors. project auto-resolves when exactly one project is ingested; pass it explicitly otherwise.

Launch command

bash
uv run --directory <repo root> python src/mcp_server.py
You rarely run this by hand — dokkai srcs registers and launches it for you. See Registration to wire it into a client manually.