code-intel-mcp

Code Intelligence MCP Server — ts-morph (TypeScript Compiler API) + ArangoDB powered code analysis for AI agents.

20 tools for deep code understanding: symbol search, call graphs, impact analysis, React component trees, hook tracking, and more. Designed for use with Claude Code, Cursor, OpenCode, pi, or any MCP-compatible AI agent.

Table of Contents

• Why code-intel-mcp?
• Quick Start
  • Install
  • Setup ArangoDB
  • Add to MCP Client
• Auto-Setup with AI Agent
• Environment Variables
• Architecture
• Tools Reference
  • Project Lifecycle
  • Search & Discovery
  • Call Graph
  • Analysis
  • Debug
  • Quick Reference
• Auto Incremental Indexing
• Streamable HTTP Mode (Daemon)
• Supported File Types
• Error Codes
• Supported Languages
• Comparison with Alternatives
• Local Development
• License

Why code-intel-mcp?

Capability	grep/ripgrep	AST tools	code-intel-mcp
Find symbol by name	partial	exact	exact + fuzzy
Call graph (who calls X?)	no	single file	multi-file, transitive
Impact analysis (what breaks if X changes?)	no	no	yes — transitive blast radius
React component tree	no	partial	JSX-aware
Hook usage tracking	no	no	yes — who uses useAuth?
Cross-file call chain A→B	no	no	pathfinding via ArangoDB
Auto incremental indexing	N/A	N/A	chokidar + ts-morph — 200ms
No JVM / No Docker	N/A	N/A	pure Node.js

Quick Start

Prerequisites

• Node.js 18+
• ArangoDB — local or remote (Docker / Cloud)

Setup ArangoDB

# Docker (quickest)
docker run -d --name arangodb -p 8529:8529 -e ARANGO_ROOT_PASSWORD=code_intel_dev arangodb/arangodb

# Or use docker-compose from the project
docker compose up -d arangodb

Install

From npm (recommended, no clone needed):

npm install -g code-intel-mcp

Or clone from source:

git clone https://github.com/HarshalRathore/code-intel-mcp.git
cd code-intel-mcp
npm install
npm run build

Add to MCP Client

{
  "mcpServers": {
    "code-intel": {
      "command": "node",
      "args": ["/usr/lib/node_modules/code-intel-mcp/dist/index.js"],
      "env": {
        "ARANGO_HOST": "http://localhost:8529",
        "ARANGO_USER": "root",
        "ARANGO_PASS": "code_intel_dev",
        "ARANGO_DB": "code_intel"
      }
    }
  }
}

Auto-Setup with AI Agent (Recommended)

Want an AI agent to set this up for you end-to-end? Copy the prompt from SETUP_PROMPT.md and paste it into Claude Code, Codex, pi, OpenCode, or Cursor.

# macOS
cat $(npm root -g)/code-intel-mcp/SETUP_PROMPT.md | pbcopy

# Linux
cat $(npm root -g)/code-intel-mcp/SETUP_PROMPT.md | xclip

# Or read it directly
cat $(npm root -g)/code-intel-mcp/SETUP_PROMPT.md

The prompt covers: prerequisite checks, npm install, ArangoDB setup, environment config, project indexing, watcher setup, MCP client configs for all major agents, verification, and troubleshooting — all in one shot.

Environment Variables

Variable	Default	Description
ARANGO_HOST	http://localhost:8529	ArangoDB host URL
ARANGO_USER	root	ArangoDB username
ARANGO_PASS	(empty)	ArangoDB password
ARANGO_DB	code_intel	ArangoDB database name
STREAMABLE_HTTP_PORT	(empty)	Set to 3001 f

... View full README on GitHub