MCP 开发代理

概述

MCP 开发代理是一个基于 Model Context Protocol (MCP) 的强大工具，提供了多种功能模块，包括内存管理、文档搜索、Git/GitHub 集成以及代码分析等。该工具支持两种操作模式：命令行界面（CLI）和服务器端事件源（SSE）模式。

功能模块

1. 内存管理

• 基于 ChromaDB 的存储与检索：利用向量数据库实现高效的信息管理和检索。
• 上下文感知搜索：支持根据上下文进行精准的内容查找。
• 时间历史记录：维护操作的历史记录，便于回溯和分析。

2. 文档搜索

• 文档查询：通过自然语言处理技术快速定位所需文档内容。
• 上下文整合：结合当前工作环境提供相关的文档建议。

3. Git/GitHub 集成

• Git 工具支持：无缝集成 Git 命令，提升版本控制效率。
• GitHub API 调用：直接与 GitHub 服务交互，管理代码库、Issues 和 Pull Requests 等操作。

4. 代码分析

• 语法解析：使用 Tree-sitter 技术对多种编程语言（如 Python、JavaScript、TypeScript）进行结构化分析。
• 代码理解：生成代码的高阶概述，识别关键组件及其职责，并提供改进建议和安全考量。

安装与配置

1. 安装方法

• 全局安装：推荐使用此方法，便于统一管理和自动配置环境。

  python setup.py install
  

• 手动安装：适合需要自定义路径或依赖管理的用户。

  pip install .
  

2. 环境变量设置

创建并编辑 config.ini 文件，添加以下配置：

[Paths]
PYTHON_EXEC = /usr/bin/python3

[GIT]
DEFAULT_GITHUB_USER = your_github_username

确保 Git 已正确配置全局用户名和邮箱：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

3. 模块依赖

安装必要的 Python 包：

pip install chromadb gitpython fastapi python-multipart

使用指南

1. 基础命令

• 启动 CLI 模式：

  mcp-agent --mode cli
  

• 代码分析示例：

  > /code analyze src/main.py
  

2. 高级功能

a. 代码结构分析

> /code analyze src/main.py

输出结果包括模块概述、关键组件识别和改进建议。

b. 文档搜索

> /docs search "如何使用 requests 库"

c. Git 操作

> /git clone https://github.com/username/repository.git

3. 服务器模式（SSE）

启动 SSE 服务：

mcp-agent --mode server

通过 HTTP 客户端发送 POST 请求以触发分析任务，响应将采用事件流格式传输。

项目架构

.
├── main.py              # 应用程序入口点
├── setup_parsers.py     # 代码解析器配置
├── tools/
│   ├── memory_tool.py   # 内存管理模块
│   ├── doc_tool.py      # 文档搜索工具
│   ├── git_tool.py      # Git 集成工具
│   └── github_tool.py   # GitHub 集成与代码分析
└── docs/
    └── api_reference.md # API 参考文档

模型配置

1. 配置文件 .agent.json

{
  "default_model": "codellama",
  "context_window": 32768,
  "temperature": 0.1,
  "top_p": 0.9
}

2. 模型选择与任务分配

• 代码文档生成：CodeLlama 模型
• 问题摘要：CodeLlama 模型
• 通用查询：Llama 2 模型

总结

MCP 开发代理通过整合多种工具和服务，为开发者提供了高效、智能的辅助功能。无论是代码分析、文档搜索还是版本控制，该工具都能显著提升开发效率和体验。

开始使用 MCP 开发代理，优化您的开发流程！