MCP Experts

🚀 MCP代碼專家系統

MCP代碼專家系統是一個基於Python構建的代碼審查系統，藉助模型上下文協議（MCP），模擬馬丁·福勒和羅伯特·C·馬丁（大Uncle Bob）等專家角色，為代碼審查提供專業建議。

🚀 快速開始

本系統要求Python 3.10或更高版本，同時需使用Ollama進行AI驅動的代碼審查。以下是詳細的安裝和配置步驟：

先決條件

Python 3.10+

該項目要求Python 3.10或更高版本。

Ollama

1. 按照平臺安裝Ollama：
   • macOS：從ollama.com下載
   • Linux：curl -fsSL https://ollama.com/install.sh | sh
   • Windows：通過WSL2支持的Linux指令
2. 拉取推薦模型：

   ollama pull llama3:8b
   

3. 啟動Ollama服務器：

   ollama serve
   

安裝

運行安裝腳本以安裝依賴項並創建虛擬環境：

chmod +x setup.sh
./setup.sh

配置

編輯.env文件以配置（根據需要從.env.example創建）：

# 知識圖譜設置
KNOWLEDGE_GRAPH_PATH=data/knowledge_graph.json

# Ollama配置（本地AI模型）
OLLAMA_HOST=http://localhost:11434
OLLAMA_MODEL=llama3:8b

✨ 主要特性

• 基於Martin Fowler重構原則的代碼審查
• 基於Robert C. Martin Clean Code原則的代碼審查
• 知識圖譜存儲代碼、評論及相關性
• 與Ollama集成以實現AI驅動的審查
• 支持服務器端事件（SSE）以便Web集成

💻 使用示例

運行服務器

標準模式（用於Cursor集成）

source .venv/bin/activate
python server.py

HTTP/SSE模式（用於Web集成）

source .venv/bin/activate
python server.py --transport sse

這將在http://localhost:8000/sse啟動SSE傳輸的服務器。 自定義端口：

python server.py --transport sse --port 9000

在Cursor中安裝

要安裝到Cursor IDE：

source .venv/bin/activate
mcp install server.py --name "Code Expert System"

可用工具

服務器公開了以下工具：

• ask_martin：請Martin Fowler審查代碼並建議重構
• ask_bob：請Robert C. Martin（Uncle Bob）根據Clean Code原則審查代碼
• read_graph：讀取整個知識圖譜
• search_nodes：在知識圖譜中搜索節點
• open_nodes：按名稱打開特定節點

基礎用法

使用Martin Fowler審查代碼片段：

{
  "code": "function calculateTotal(items) {\n  var total = 0;\n  for (var i = 0; i < items.length; i++) {\n    total += items[i].price;\n  }\n  return total;\n}",
  "language": "javascript"
}

📚 詳細文檔

項目結構

• server.py：主服務器文件
• config.py：配置設置
• knowledge_graph.py：知識圖譜功能
• models/：AI模型接口
• templates/：Web界面模板

架構

系統由以下模塊組成：

• 服務器：處理請求並協調各個組件。
• 知識圖譜：存儲和管理代碼及其關係。
• Ollama集成：與AI服務交互以提供智能審查。
• Web界面：用戶友好的界面進行代碼審查。

📄 許可證

MIT License