MCP 服务器

MCP Code Expert System

一个基于 Python 的系统，通过模拟 Martin Fowler 和 Robert C. Martin 等专家角色，并使用模型上下文协议 (MCP) 提供 AI 驱动的代码审查。

README

MCP 代码专家系统

一个基于 Python 的代码审查系统，使用模型上下文协议 (MCP)。它通过模拟 Martin Fowler 和 Robert C. Martin (Uncle Bob) 等专家角色提供代码审查功能。

功能

基于 Martin Fowler 的重构原则的代码审查
基于 Robert C. Martin 的《代码整洁之道》原则的代码审查
代码、审查和关系知识图谱存储
与 Ollama 集成，实现 AI 驱动的审查
服务器发送事件 (SSE) 支持 Web 集成

前提条件

Python 3.10+

本项目需要 Python 3.10 或更高版本。

Ollama

Ollama 是 AI 驱动的代码审查所必需的。

为您的平台安装 Ollama：
- macOS: 从 ollama.com 下载
- Linux: curl -fsSL https://ollama.com/install.sh | sh
- Windows: 通过 Linux 指令支持 Windows WSL2
拉取推荐的模型：
```
ollama pull llama3:8b
```
启动 Ollama 服务器：
```
ollama serve
```

安装

运行 setup 脚本以安装依赖项并创建虚拟环境：

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

用法

运行服务器

标准模式（用于 Cursor 集成）

source .venv/bin/activate
python server.py

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

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

这将启动服务器，SSE 传输地址为 http://localhost:8000/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) 基于《代码整洁之道》原则审查代码
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",
  "description": "Calculate the total price of items"
}

项目结构

server.py: 带有 MCP 集成的主服务器实现
experts/: 实现代码审查功能的专家模块
- __init__.py: 共享模型和接口
- martin_fowler/: Martin Fowler 专家实现
- robert_c_martin/: Robert C. Martin 专家实现
knowledge_graph.py: 用于存储代码和审查的知识图谱
ollama_service.py: 与 Ollama 集成，实现 AI 驱动的审查
examples/: 不同语言的审查示例代码
requirements.txt: Python 依赖项
setup.sh: 安装脚本