Datagraph MCP

Datagraph MCP is a CodeGraph-first MCP server for semantic code intelligence. It publishes a stdio CLI that can be launched by any MCP client with:

npx datagraph-mcp

It also supports local project initialization:

npx datagraph-mcp init -i

That initializes CodeGraph in the current project and runs the first index pass.

For implementation and runtime notes, see codegraph.md.

What this project does

The server exposes CodeGraph tools that help agents understand codebases faster:

• symbol search
• contextual code exploration
• caller and callee discovery
• impact analysis
• node detail lookups
• deep file-grouped exploration
• index status checks
• indexed file tree inspection

Published CLI usage

Local project init

datagraph-mcp init -i

Use -i to index after initialization. You can also pass a project path:

datagraph-mcp init C:/path/to/project -i

Claude Desktop example

{
  "mcpServers": {
    "datagraph-mcp": {
      "command": "npx",
      "args": ["datagraph-mcp"],
      "env": {
        "CODEGRAPH_ENABLED": "true",
        "CODEGRAPH_AUTO_BOOTSTRAP": "true",
        "CODEGRAPH_PROJECT_PATH": "C:/path/to/project",
        "CODEGRAPH_ALLOWED_ROOTS": "C:/path/to"
      }
    }
  }
}

If you run it from a shell instead of an MCP client, set the same environment variables first.

Tool catalog

• codegraph_search
• codegraph_context
• codegraph_callers
• codegraph_callees
• codegraph_impact
• codegraph_node
• codegraph_explore
• codegraph_status
• codegraph_files

Environment variables

CODEGRAPH_ENABLED=true
CODEGRAPH_AUTO_BOOTSTRAP=true
CODEGRAPH_PROJECT_PATH=C:\path\to\indexed\project
CODEGRAPH_ALLOWED_ROOTS=C:\path\to
CODEGRAPH_MAX_SEARCH_LIMIT=20
CODEGRAPH_MAX_CONTEXT_NODES=30
CODEGRAPH_MAX_CALL_LIMIT=30
CODEGRAPH_MAX_IMPACT_DEPTH=4
CODEGRAPH_MAX_EXPLORE_FILES=12
CODEGRAPH_MAX_FILES_DEPTH=10
MCP_UI_ORIGIN=https://your-allowed-ui.example.com

Notes:

• CODEGRAPH_ENABLED=false disables all codegraph_* tools.
• CODEGRAPH_AUTO_BOOTSTRAP=true initializes and indexes a target repository on first tool call if .codegraph/ is missing.
• CODEGRAPH_ALLOWED_ROOTS is a comma-separated allowlist for optional projectPath inputs.

Local development

1. Install dependencies:
   • npm install
2. Copy .env.example to .env
3. Set your CODEGRAPH_* variables
4. Run local app:
   • npm run dev
5. Build stdio bundle:
   • npm run mcp:stdio:build
6. Run stdio MCP server:
   • npm run mcp:stdio

Publish to npm

1. Ensure npm auth:
   • npm adduser
2. Verify package contents:
   • npm pack --dry-run
3. Publish:
   • npm publish --access public

Build commands

• npm run dev
• npm run build
• npm run start
• npm run mcp:stdio:build
• npm run mcp:stdio
• npm run lint