Code Intel

CI PyPI License: MIT Python 3.11+

MCP server that gives AI agents deep code understanding across multiple git repositories. Combines git lifecycle management, Zoekt-based trigram code search, and cross-repo dependency analysis.

Quick Start (macOS)

Prerequisites

Install uv (Python package runner):

brew install uv

1. Setup (one time)

uvx code-intel-mcp setup --zoekt-url "https://github.com/arunveersingh/code-intel-mcp/releases/download/v0.1.0"

This creates ~/.code-intel-mcp/ directories and downloads the Zoekt search engine binaries.

2. Add to your MCP client

Kiro — add to ~/.kiro/settings/mcp.json inside "mcpServers":

"code-intel-mcp": {
  "command": "uvx",
  "args": ["code-intel-mcp", "serve"],
  "env": {
    "GITLAB_URL": "https://your-gitlab.com",
    "GITLAB_TOKEN": "<your-personal-access-token>"
  },
  "disabled": false,
  "autoApprove": []
}

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json inside "mcpServers":

"code-intel-mcp": {
  "command": "uvx",
  "args": ["code-intel-mcp", "serve"],
  "env": {
    "GITLAB_URL": "https://your-gitlab.com",
    "GITLAB_TOKEN": "<your-personal-access-token>"
  }
}

3. Done

Restart your MCP client. Your AI agent now has access to 15 tools for code intelligence.

Features

• Git lifecycle — clone, pull, checkout, sync, and remove repositories
• GitLab integration — bulk-clone entire GitLab groups
• Code search — fast trigram-based search powered by Zoekt
• File browsing — read files, list directories, get repo overviews
• Dependency analysis — parse Maven, Gradle, and npm build configs
• Symbol references — word-boundary search across repos

Available Tools

Environment Variables

How It Works

The server manages a local repository store at ~/.code-intel-mcp/:

~/.code-intel-mcp/
├── repos/       # Cloned git repositories
├── index/       # Zoekt search index
├── bin/         # Zoekt binaries (auto-installed)
└── config.json  # Registry of managed repos

Every git mutation (clone, pull, checkout) automatically triggers Zoekt re-indexing, keeping search results current. The server auto-prepends ~/.code-intel-mcp/bin to PATH on startup, so no manual PATH configuration is needed.

Troubleshooting

spawn code-intel-mcp ENOENT — Use "command": "uvx" with "args": ["code-intel-mcp", "serve"], not "command": "code-intel-mcp".

Requires-Python >=3.11 — Use uvx instead of pip install. It handles Python versions automatically.

Zoekt binaries not found — Re-run setup: uvx code-intel-mcp setup --zoekt-url "https://github.com/arunveersingh/code-intel-mcp/releases/download/v0.1.0"

Development

git clone https://github.com/arunveersingh/code-intel-mcp.git
cd code-intel-mcp
python3 -m venv .venv && source .venv/bin/activate
pip install hatchling && python3 -m hatchling build -t wheel
pip install dist/*.whl && pip install pytest pytest-asyncio hypothesis
pytest

License

MIT — see LICENSE.