🚀 MCP代码智能
停止浪费代币。开始更智能地编码。
标准的人工智能助手是“代币饥饿”的。当你问一个简单的问题时,他们通常会为了找到一个引用而摄入数千行不相关的代码,导致大量代币浪费、API成本高和响应慢。
mcp代码智能 通过将重物移至本地机器来解决此问题:
- 精确上下文: 使用Local Jina v3,我们只确定所需的确切代码片段。不再将整个文件发送到云端。
- 零废物分析: 我们的系统过滤掉了“噪音”,将提示大小减少了80%。
- 成本杀手: 通过为LLM提供外科手术般的精确度而不是“蛮力”的上下文,您可以在获得更快、更准确的答案的同时节省每一个查询的费用。
💎 为什么选择MCP代码智能而不是标准AI聊天?
🔍 search_code · Fast semantic code search using local Jina V3 vector engine. No token limits, instant results, context-aware (unlike standard AI chat's slow, token-limited grep).
🧩 search_similar · Detects duplicate or similar logic across your codebase, saving time and reducing technical debt.
💬 search_context · Finds code by natural language description, leveraging project embeddings for precise results.
📊 get_project_status · Instantly shows indexing, language, and health status—no manual inspection needed.
⚡ index_project · Local, parallel indexing for large codebases. Much faster than cloud-based AI parsing.
🧠 analyze_project / analyze_file · Deep analysis (complexity, health, code smells) with no token or context window limits. Results are project-wide and actionable.
🚨 find_smells · Pinpoints anti-patterns and code smells, improving code quality and maintainability.
🔥 get_complexity_hotspots · Highlights the most complex files/functions for targeted refactoring.
🔗 check_circular_dependencies · Detects hidden import cycles instantly—no need for manual graph analysis.
🔎 find_symbol / get_relationships · Symbol search and call graph mapping with full project context, not just open files.
📝 interpret_analysis · Summarizes analysis for human or AI consumption, enabling smarter decisions.
🧬 find_duplicates · Locates duplicate code blocks, reducing redundancy and improving maintainability.
🔕 silence_health_issue · Suppresses noisy warnings, keeping your workflow focused.
🛑 propose_logic · Prevents logic duplication before you code, saving tokens and review time.
📈 analyze_impact · Predicts the effect of changes before you refactor, avoiding costly mistakes.
🛡️ Guardian (health/logic checks) · Real-time health and duplication guard, ensuring codebase integrity.
📄 read_file · Read full contents of a specific file (use as last resort when LSP tools don't suffice).
✍️ write_file · Write content to a file, creating parent directories if needed (use with caution).
📂 list_directory · List contents of a directory to explore repository layout and discover files.
📋 list_files · Alias for list_directory - browse project structure efficiently.
🔧 debug_ping · Diagnostic tool to verify MCP server connection and version information.
🎯 goto_definition / find_references · High-precision LSP-powered navigation for exact symbol definitions and usage locations.
令牌和速度优势:
- 所有工具都在本地运行,因此没有令牌限制或API速率限制。
- 结果是即时的,即使对于大型项目也是如此(这要归功于向量搜索和并行分析)。
- 没有云延迟——您的数据保持私密和快速。
质量和环境优势:
- 工具使用项目的完整图形和嵌入,而不仅仅是文件片段。
- 结果总是相关的、可操作的,并且是针对您的代码库量身定制的。
✨ 尖端功能
- python 通过以下方式实现全类型智能
python-lsp-server. - JS/TS: 通过智能导航
typescript-language-server. - 飞镖/颤振: 移动开发优化了智能。
- Rust/Go/C++: 完全支持的高性能LSP。
- ⚡ 智能优先级索引: 大型项目?没问题系统为您的 Git更改, 入口点,以及 自述文件 在前60秒内,您可以开始工作,而其余的工作则在后台完成。
- 🏠 100%本地情报: 所有向量操作和嵌入都保留在您的机器上。任何代码都不会离开你的项目。
- 🛡️ 项目健康守护者(智能通知): 该系统持续监控您的项目是否存在技术债务。当完全重复或占位符为空时,它会在您的AI聊天中注入非侵入性警告(
pass/...)被检测到,帮助您实时维护干净的代码库。 - 🕵️ 三级重复检测: 超越简单的文本匹配:
- 第三级(精确): 用于复制粘贴检测的MD5/SHA256哈希匹配。
- 2级(结构): 基于AST的骨架分析(不同名称,相同算法)。
- 级别1(语义): Jina v3 AI分析,找出执行相同任务的不同代码。
🚀 快速启动(一个命令设置)
在一分钟内启动并运行任何项目:```bash
1. (Recommended) Create and activate a clean environment
Windows:
python -m venv venv
.\venv\Scripts\activate
Mac/Linux:
python3 -m venv venv
source venv/bin/activate
2. Clone the repository to your local machine
git clone https://github.com/mahkande/mcp-code-intelligence.git
cd mcp-code-intelligence
3. Install the package (This makes the 'mcp-code-intelligence' command available everywhere)
pip install .
4. Initialize & Connect to your AI Editor
Run this once. It auto-detects your editors and configures them.
mcp-code-intelligence setup
智能设置将:
1. **检测** 您的语言和平台(克劳德桌面、光标等)
1. **下载** 优化了Jina v3的权重。
1. **优先处理** 并为你的代码库建立索引。
1. **注入** 自动配置到您的AI工具中。
______________________________________________________________________
## 📖 命令参考
### 🧠 情报与搜索
- `mcp-code-intelligence setup`:推荐的开始方式。自动检测一切并配置您的环境。
- `mcp-code-intelligence search "query"`:使用自然语言的语义搜索。
- `mcp-code-intelligence chat "question"`:交互式LLM聊天关于您的代码库(需要OpenRouter API密钥)。
- `mcp-code-intelligence duplicates`:运行高精度、3级扫描以查找重复代码块。
- `mcp-code-intelligence analyze`:运行复杂性和质量分析(认知/圈复杂度、代码气味)。
### 📊 状态和可视化
- `mcp-code-intelligence status`:检查索引进度、数据库运行状况和项目统计信息。
- `mcp-code-intelligence visualize serve`:在浏览器中启动代码结构的本地3D交互式图形。
- `mcp-code-intelligence doctor`:用于检查依赖关系(Python、Node、Git)和路径配置的诊断工具。
### 🛠️ 维护与高级
- `mcp-code-intelligence index`:手动触发或强制重新索引代码库。
- `mcp-code-intelligence reset`:清白。删除现有索引并恢复出厂设置。
- `mcp-code-intelligence config`:微调设置,如 `similarity_threshold` 或者更改嵌入模型。
- `mcp-code-intelligence silence_health_issue `:根据特定健康警告的ID手动将其静音。
### 🛡️ 管理健康守护者
默认情况下,Guardian系统已启用,以保持代码库的干净。您可以通过CLI进行管理:
- **禁用监护人:** `mcp-code-intelligence config set enable_guardian false`
- **启用监护人:** `mcp-code-intelligence config set enable_guardian true`
- **切换逻辑检查:** `mcp-code-intelligence config set enable_logic_check false`
- **忽略特定代码:** 添加 `# guardian-ignore` 作为任何函数或类中的注释,跳过该块的健康检查。
______________________________________________________________________
### 📺 监控
- `mcp-code-intelligence onboarding logs`: **实时仪表板。** 实时监控后台活动、搜索日志和AI工具交互。
______________________________________________________________________
## 🗑️ 如何移除? (卸载)
如果 MCP Code Intelligence 集成在您的编辑器中出现问题或想要删除它,您可以使用以下命令:
- **自动卸载(最常见的平台):**```sh
mcp-code-intelligence uninstall mcp
- 从特定编辑器中删除:```sh
mcp-code-intelligence uninstall mcp --platform cursor
mcp-code-intelligence uninstall mcp --platform claude-desktop
- **从所有平台进行批量卸载:**```sh
mcp-code-intelligence uninstall mcp --all
- 列出可用的集成:
sh mcp-code-intelligence uninstall list
建议您在卸载后重新启动编辑器。
🛠️ 需求
-
Python 3.10+
-
Git (用于智能优先级排序)
-
Node.js (可选,用于JS/TS LSP支持)
-
MCP代码智能扩展 (VS Code用户需要)
-
VS代码: 此项目包括一个打包的扩展文件夹
mcp-vscode-extension. - 光标: 原生MCP支持。
- 克劳德桌面/代码: 原生MCP支持。
> 注: VS代码需要在中进行正确配置 settings.json (Copilot Chat)或帮助扩展来弥合上下文差距。此存储库为此目的提供了一个辅助扩展。
由开发人员构建,面向重视上下文窗口(和钱包)的开发人员。 🛡️✨
