code-context MCP sunucusu
Commit 25 Eki 2026AI kodlama ajanlarının bağlam verimliliğini artırmak için AST tabanlı kod tabanı zekası, sembol çıkarma ve siklomatik karmaşıklık analizi sağlar.
Ayrıca bilinen adı jitendrakumar-ai/code-context-mcp
- Yıldızlar
- 1
- Araçlar
- 5
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 25 Eki 2026
- Lisans
- MIT
code-context MCP nedir?
AI kodlama ajanlarının bağlam verimliliğini artırmak için AST tabanlı kod tabanı zekası, sembol çıkarma ve siklomatik karmaşıklık analizi sağlar. 5 araç sunar; örneğin summarize_repository_architecture, extract_python_ast_symbols, analyze_cyclomatic_complexity.
Özet, projenin README dosyasından oluşturuldu
code-context MCP sunucusu hakkında
Bu sunucu, ham dosya içeriği aktarmak yerine yapılandırılmış zeka sunarak AI kodlama ajanlarına hassas kod bağlamı sağlar. Claude Code, Cursor, Windsurf veya Codex gibi araçları kullanan geliştiricilerin, Python kod tabanlarından yalnızca gerekli yapısal bilgileri çıkararak token kullanımını azaltmalarına yardımcı olur. Sunucu, tüm dosyaları göndermek yerine bağlam pencerelerini verimli tutmak için bir Abstract Syntax Tree (AST) temsili sunar.
Kullanıcılar bu sunucuyu stdio üzerinden yerel olarak çalıştırır; bu da herhangi bir harici API anahtarı veya telemetri gerektirmeden tamamen çevrimdışı çalıştığı anlamına gelir. Sunucu, üst düzey bir depo özetiyle başlayan, ardından detaylı sembol çıkarma ve karmaşıklık analizine geçen üç katmanlı bir iş akışı ile işlev görür. Bir AI ajanı, extract_python_ast_symbols ve analyze_cyclomatic_complexity gibi özel araçları kullanarak, aşırı token tüketmeden sınıf tanımlarını, metod imzalarını ve refactoring ihtiyaçlarını anlayabilir.
Neler yapabilirsiniz
- 1Depo yapısını haritalandırınAI'dan dosya ağacının ve modül giriş noktalarının üst düzey bir özetini sunmasını isteyin.
- 2Belirli kod sembollerini çıkarınBelirli bir Python dosyası için sınıfların, metodların ve docstring'lerin detaylı bir taslağını talep edin.
- 3Refactoring hedeflerini belirleyinYüksek siklomatik karmaşıklığa sahip olan ve modüler hale getirilmesi gereken fonksiyonları bulun.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
code-context MCP araçları 5
README dosyasından algılandısummarize_repository_architectureextract_python_ast_symbolsanalyze_cyclomatic_complexityget_refactoring_contextsearch_code_todos_and_hotspots
| summarize_repository_architecture | — | |
| extract_python_ast_symbols | — | |
| analyze_cyclomatic_complexity | — | |
| get_refactoring_context | — | |
| search_code_todos_and_hotspots | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirjitendrakumar-ai/code-context-mcp is public and reachablegithub.com/jitendrakumar-ai/code-context-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-25github.com/jitendrakumar-ai/code-context-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
<
AST Codebase Intelligence, Symbol Extraction, Cyclomatic Complexity & Refactoring Analysis for LLMs & AI Coding Agents.
💡 Why This Exists & Token Efficiency
Traditional AI coding assistants dump entire raw source files into context windows, wasting tens of thousands of tokens on boilerplate, imports, and irrelevant functions. code-context-mcp introduces a claude-mem style 3-layer workflow that provides surgical code context before editing.
🚀 Quick Start
Multi-IDE Quick Start
Claude Code
Add to your ~/.claude.json:
{
"mcpServers": {
"code-context-mcp": {
"command": "python3",
"args": ["/path/to/code_context_mcp.py"]
}
}
}
Cursor
Go to Settings > Features > MCP and add:
- Name:
code-context-mcp - Type:
stdio - Command:
python3 /path/to/code_context_mcp.py
Codex
Add to codex.config.toml:
[mcp.servers.code-context-mcp]
command = "python3"
args = ["/path/to/code_context_mcp.py"]
Antigravity
Add to .antigravity/mcp_config.json:
{
"mcpServers": {
"code-context-mcp": {
"command": "python3",
"args": ["/path/to/code_context_mcp.py"]
}
}
}
OpenCode
Add to opencode.json:
{
"mcpServers": {
"code-context-mcp": {
"command": "python3",
"args": ["/path/to/code_context_mcp.py"]
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"code-context-mcp": {
"command": "python3",
"args": ["/path/to/code_context_mcp.py"]
}
}
}
🛠️ How It Works
code-context-mcp runs as a standard Model Context Protocol (MCP) server communicating over stdio. It builds an Abstract Syntax Tree (AST) representation of Python source code locally and computes function metrics without sending data externally.
🧬 3-Layer Workflow
Layer 1: Repository Architecture Summary
# Call tool: summarize_repository_architecture
response = summarize_repository_architecture(root_dir=".")
print(response)
# Returns file tree, line counts, extension distribution, and module entry points.
Layer 2: AST Symbol Outline
# Call tool: extract_python_ast_symbols
response = extract_python_ast_symbols(file_path="code_context_mcp.py")
print(response)
# Returns class definitions, method signatures, decorator usages, and docstrings.
Layer 3: Cyclomatic Complexity & Refactoring Insights
# Call tool: analyze_cyclomatic_complexity
response = analyze_cyclomatic_complexity(file_path="code_context_mcp.py", threshold=10)
print(response)
# Identifies high-complexity methods and recommends specific modular refactorings.
🔧 MCP Tools
| Tool | Parameters | Description |
|---|---|---|
summarize_repository_architecture |
root_dir (str) |
High-level repository structure & file metrics. |
extract_python_ast_symbols |
file_path (str) |
AST symbol tree (Classes, Functions, Imports). |
analyze_cyclomatic_complexity |
file_path (str), threshold (int) |
Complexity metrics & actionable refactoring prompts. |
get_refactoring_context |
file_path (str), symbol_name (str) |
Targeted code extraction for surgical AI code edits. |
🏗️ Architecture
+-------------------------------------------------------+
| AI Coding Agent |
| (Claude Code / Cursor / Codex / Antigravity / etc.) |
+---------------------------+---------------------------+
| MCP (stdio)
v
+-------------------------------------------------------+
| code-context-mcp |
| |
| +--------------------+ +--------------------+ |
| | AST Parser Engine | | Cyclomatic Engine | |
| +--------------------+ +--------------------+ |
| | Symbol Extractor | | Refactor Context | |
| +--------------------+ +--------------------+ |
+-------------------------------------------------------+
🛡️ Security
code-context-mcp works 100% offline and locally. Zero telemetry, zero external API requests. See SECURITY.md for vulnerability disclosure policy.
📄 License
Distributed under the MIT License. See LICENSE for more details.--26-7928CA?style=for-the-badge" alt="MCP Spec" />
AST Codebase Intelligence, Symbol Extraction, Cyclomatic Complexity & Refactoring Analysis for LLMs & AI Coding Agents.
💡 Why This Exists & Token Efficiency
Traditional AI coding assistants dump entire raw source files into context windows, wasting tens of thousands of tokens on boilerplate, imports, and irrelevant functions. code-context-mcp introduces a claude-mem style 3-layer workflow that provides surgical code context before editing.
⚡ 3-Layer Context Workflow
- Layer 1: Structural Scan (
summarize_repository_architecture) — High-level file structure, line counts, and extensions map. - Layer 2: AST Symbol Outline (
extract_python_ast_symbols) — Class definitions, method signatures, docstrings, and line ranges without dumping raw code. - Layer 3: Targeted Analysis (
analyze_cyclomatic_complexity&search_code_todos_and_hotspots) — Cyclomatic complexity scores and TODO/FIXME hotspot discovery to pinpoint refactoring targets.
📊 Token Savings Comparison
| Approach | Context Injected | Token Usage | Accuracy | Savings |
|---|---|---|---|---|
| Naive Raw File Dumping | Entire source files | ~45,000 tokens | Moderate | 0% |
| Naive Grep Search | Raw line matches | ~18,000 tokens | Low | ~60% |
code-context-mcp AST Workflow |
Exact AST symbols & complexity | ~6,500 tokens | High | ~85% Savings 🚀 |
🏗️ Architecture Diagram
flowchart TD
A[AI Coding Agent / LLM] -->|1. Request Repo Summary| B[summarize_repository_architecture]
A -->|2. Extract AST Symbols| C[extract_python_ast_symbols]
A -->|3. Analyze Complexity| D[analyze_cyclomatic_complexity]
A -->|4. Scan Hotspots| E[search_code_todos_and_hotspots]
subgraph MCP Server Engine: code-context-mcp
B --> F[AST & Static Code Parser]
C --> F
D --> F
E --> F
end
F -->|Compact Structural Context| A
🛠️ Tools Included
summarize_repository_architecture: Scans directory paths, generates file structure breakdown by extension, and computes total lines of code.extract_python_ast_symbols: Parses Python files into Abstract Syntax Trees (AST) to extract classes, base classes, methods, docstrings, function signatures, and line markers.analyze_cyclomatic_complexity: Calculates cyclomatic complexity scores for all functions/methods to identify refactoring candidates and branch depth.search_code_todos_and_hotspots: Detects code comments containingTODO,FIXME,HACK, andXXXacross the codebase with exact file and line references.
🚀 Quick Start (1-Click & 1-Command Setup)
1. Claude Code CLI
claude mcp add code-context-mcp -- python -m code_context_mcp
2. Cursor (.cursor/mcp.json)
{
"mcpServers": {
"code-context-mcp": {
"command": "python",
"args": ["-m", "code_context_mcp"]
}
}
}
3. OpenAI Codex CLI (~/.codex/config.toml)
[mcp_servers.code-context-mcp]
command = "python"
args = ["-m", "code_context_mcp"]
4. Google Antigravity IDE (mcp_config.json)
{
"mcpServers": {
"code-context-mcp": {
"command": "python",
"args": ["-m", "code_context_mcp"]
}
}
}
5. Windsurf / Cline
{
"mcpServers": {
"code-context-mcp": {
"command": "python",
"args": ["-m", "code_context_mcp"]
}
}
}
code-context MCP soruları
code-context MCP hangi araçları sunar?
5 araç sunar; bunlar arasında summarize_repository_architecture, extract_python_ast_symbols, analyze_cyclomatic_complexity, get_refactoring_context, search_code_todos_and_hotspots yer alır.
Bu sunucu herhangi bir API anahtarı gerektiriyor mu?
Hayır, sunucu herhangi bir harici API anahtarına ihtiyaç duymadan çalışır.
Kodlarım harici sunuculara gönderiliyor mu?
Hayır, sunucu tamamen çevrimdışı ve yerel olarak çalışır; hiçbir telemetri veya harici API isteği gerçekleştirmez.
Token verimliliğini nasıl artırıyor?
Dosyaların tamamını göndermek yerine, AST sembolleri ve karmaşıklık metrikleri gibi nokta atışı bağlamlar sağlayan 3 katmanlı bir iş akışı kullanarak token kullanımını %85'e kadar azaltır.