@wrongstack/codebase-index-mcp

Expose WrongStack's project-scoped Codebase Index daemon to any MCP client. The MCP process is only a protocol adapter: search, stats, graphs, and index updates still go through the existing named-pipe/Unix-socket IPC service, so the detached project daemon remains the single SQLite owner.

Usage

wstack-codebase-index-mcp --project-root /absolute/path/to/project

The default stdio surface is read-only:

• codebase_search
• codebase_stats
• codebase_package_graph
• codebase_file_graph
• codebase_symbol_graph

Add --writable to expose codebase_index, which can incrementally refresh or fully rebuild the index:

wstack-codebase-index-mcp --project-root /absolute/path/to/project --writable

Loopback HTTP is also available:

wstack-codebase-index-mcp --project-root /absolute/path/to/project --http --port 8767

Non-loopback HTTP binds require --token; the shared MCP HTTP transport rejects an unauthenticated public bind.

MCP client configuration

{
  "mcpServers": {
    "wrongstack-codebase-index": {
      "command": "wstack-codebase-index-mcp",
      "args": ["--project-root", "/absolute/path/to/project", "--writable"]
    }
  }
}