CodeInteliMCP - Intelligent Code Analysis Server
An advanced MCP (Model Context Protocol) server that combines Tree-sitter parsing with graph databases and vector search for lightning-fast code intelligence across multiple repositories.
🚀 Features
- Multi-Repository Support: Manage and analyze multiple codebases simultaneously
- Instant Usage Search: Find where functions/classes are used in milliseconds
- Semantic Code Search: Find similar code patterns using vector embeddings
- Dependency Analysis: Visualize and query code dependencies
- Impact Analysis: See what breaks when you change something
- Auto-indexing: Smart incremental updates as you code
- Multi-language Support: Python, JavaScript, TypeScript, Go, Rust, and more
🏗 Architecture
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude Code │────▶│ MCP Server │────▶│ Tree-sitter │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │
▼ ▼
┌──────────────┐ ┌────────────────┐
│ DuckDB │ │ ChromaDB │
│ (Graph) │ │ (Vectors) │
└──────────────┘ └────────────────┘
🎯 Core Capabilities
1. Graph Queries (via DuckDB)
- Function call relationships
- Import dependencies
- Class inheritance trees
- Variable usage tracking
2. Vector Search (via ChromaDB)
- Semantic code similarity
- Natural language code search
- Pattern detection
- Code duplication finding
3. Real-time Analysis (via Tree-sitter)
- On-demand parsing
- Syntax validation
- Code structure analysis
- AST manipulation
🚦 Quick Start
Automated Setup (Recommended)
# Clone the repository
git clone https://github.com/rahulvgmail/CodeInteliMCP.git
cd CodeInteliMCP
# Run the setup script
python setup_for_claude.py
The setup script will:
- Install all dependencies
- Configure Claude Desktop/Code
- Create data directories
- Set up environment variables
Manual Setup
# Install dependencies
pip install mcp duckdb chromadb sentence-transformers aiofiles
pip install tree-sitter tree-sitter-python tree-sitter-javascript
# Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"code-intelligence": {
"command": "python",
"args": ["/path/to/CodeInteliMCP/code_intelligence_mcp/server_minimal.py"],
"env": {
"CODE_INTEL_PROJECT_ROOT": "/path/to/your/project"
}
}
}
}
🛠️ Available Tools
This MCP server provides the following tools:
Repository Management
-
add_repository- Add a new repository to trackname(string, required): Repository namepath(string, required): Path to repositorydescription(string, optional): Repository descriptionmake_active(boolean, optional): Set as active repository
-
list_repositories- List all tracked repositories -
set_active_repository- Set the active repository for operationsname(string, required): Repository name to make active
-
index_repository- Index an entire repositoryrepository_name(string, required): Name of repository to indexinclude_patterns(string, optional): Comma-separated file patterns to includeexclude_patterns(string, optional): Comma-separated file patterns to exclude
Code Analysis
-
index_file- Index a single file into the code graphfile_path(string, required): Path to the file to index
-
find_symbol- Find a symbol by namename(string, required): Symbol name to search forfile_path(string, optional): Limit search to specific file
-
find_usages- Find all usages of a symbolname(string, required): Symbol name to find usages forfile_path(string, optional): Limit search to specific file
-
semantic_search- Search for code using semantic similarityquery(string, required): Natural language search querylimit(integer, optional): Maximum number of results (default: 10)symbol_types(string, optional): Comma-separated list of symbol types to filter
-
find_similar_code- Find code similar to a given symbolsymbol_name(string, required): Reference symbol namefile_path(string, optional): File containing the reference symbol
System Tools
-
test_connection- Test that the server is working -
get_index_stats- Get current index statistics -
get_vector_stats- Get vector store statistics
📖 Usage Examples
Once configured, use these tools in Claude:
# Add a new repository
add_repository(name="my-app", path="/path/to/my-app", description="Main application")
# Index the repository
index_repository(repository_name="my-app", include_patterns="**/*.py,**/*.js")
# Search for authentication functions
semantic_search(query="authentication and login functions", limit=20)
# Find where a class is used
find_usages(name="UserService")
# Find similar implementations
find_similar_code(symbol_name="login_user")
📚 Documentation
- USER_GUIDE.md: Complete setup and usage guide
- ARCHITECTURE.md: Technical architecture details
- IMPLEMENTATION_PLAN.md: Development roadmap
📊 Performance Targets
- Initial indexing: < 1 minute for 100k LOC
- Incremental updates: < 1 second per file
- Usage queries: < 50ms
- Semantic search: < 200ms
Metadata
Release files for iflow-mcp_rahulvgmail-codeintelimcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_rahulvgmail_codeintelimcp-0.1.0.tar.gz | 32.8 kB | Without provenance | Details for iflow_mcp_rahulvgmail_codeintelimcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_rahulvgmail_codeintelimcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_rahulvgmail_codeintelimcp-0.1.0-py3-none-any.whl |
Total release size: 72.9 kB
Release files / iflow_mcp_rahulvgmail_codeintelimcp-0.1.0.tar.gz
| Download URL | iflow_mcp_rahulvgmail_codeintelimcp-0.1.0.tar.gz |
|---|---|
| Size | 32.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d7f5e8dfef11e98432e2148d18d066f1668042a660400f6ddf2aed9421d270e0
|
|
BLAKE2b-256 checksum How to use checksums |
a969e72a958597d45d788db00898dee7784a6a6238b3a0d90d4ac99e3cab230f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_rahulvgmail_codeintelimcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_rahulvgmail_codeintelimcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 40.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
eb648c76a7c9cb7bb5d8e547891026e79d4e7528d0b337ecf7dd13e4bec14942
|
|
BLAKE2b-256 checksum How to use checksums |
6e576e7060654a9280b23f1b6881a3409b444f919ef8f1670f9acf233aea1cc3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_rahulvgmail-codeintelimcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.