Code Graph MCP Server

A code indexing system that creates searchable code graphs accessible via MCP (Model Context Protocol) for LLM consumption.

Features

- 🔍 Semantic Code Search - Search across multiple repositories with context
- 📊 Code Graph Analysis - Understand relationships between functions, classes, and modules
- 🚀 Fast Indexing - Targeted repository indexing for relevant codebases only
- 🔌 MCP Integration - Direct LLM access via Model Context Protocol
- 🛠️ Multi-Language Support - TypeScript, JavaScript, Python, Go, Rust, Java via Tree-sitter
- 📱 Cross-Platform - Works on Windows, macOS, and Linux

Quick Start

$3

``bash
npx code-graph-mcp
`

$3

1. Configure Repositories: Edit config/repos.json to specify which repositories to index:

`json
{
"repositories": [
{
"url": "https://github.com/your-org/your-repo",
"name": "your-repo",
"priority": "high"
}
]
}
`

2. Index Repositories (automatically syncs and indexes):

`bash
npx code-graph-mcp index
`

3. Start MCP Server:

`bash
npx code-graph-mcp start
`

Architecture

$3

- Repository Manager - Clone and manage repositories from config list
- Code Parser - Extract symbols, AST, relationships using tree-sitter
- Graph Database - Store code relationships in SQLite
- Search Engine - Semantic and structural code search
- MCP Server - Protocol interface for LLM access
- CLI Interface - Management and configuration tools

$3

- search_code - Semantic code search across repositories
- find_references - Find symbol usage and references
- get_call_graph - Trace function calls and dependencies
- analyze_dependencies - File/module dependency analysis
- get_symbol_info - Symbol definitions and documentation
- explore_codebase - High-level structure analysis

Configuration

$3

The config/repos.json file defines which repositories to index:

`json
{
"repositories": [
{
"url": "https://github.com/microsoft/vscode",
"name": "vscode",
"priority": "high",
"branch": "main",
"include": ["src/*/.ts"],
"exclude": ["node_modules/", "/.test."]
}
],
"settings": {
"maxFileSize": "1MB",
"indexBinaryFiles": false,
"languages": ["typescript", "javascript", "python"],
"updateInterval": "1h"
}
}
`

Development

$3

`bash
npm run build
`

$3

`bash
npm run dev
`

$3

`bash
npm test
``

License

MIT