🚀 MCP 开发代理
MCP 开发代理是一款基于 Model Context Protocol (MCP) 的强大工具，它集成了内存管理、文档搜索、Git/GitHub 集成以及代码分析等多个功能模块。支持命令行界面（CLI）和服务器端事件源（SSE）两种操作模式，能有效提升开发者的工作效率。
🚀 快速开始
MCP 开发代理为开发者提供了高效、智能的辅助功能，能显著提升开发效率和体验。你可以按照以下步骤开始使用：
- 参考“📦 安装指南”完成工具的安装与配置。
- 依据“💻 使用指南”中的命令和示例，开启 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. 高级用法
代码结构分析
> /code analyze src/main.py
输出结果包含模块概述、关键组件识别和改进建议。
文档搜索
> /docs search "如何使用 requests 库"
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 参考文档
模型配置
配置文件 .agent.json
{
"default_model": "codellama",
"context_window": 32768,
"temperature": 0.1,
"top_p": 0.9
}
模型选择与任务分配
| 任务类型 | 模型选择 |
|---|---|
| 代码文档生成 | CodeLlama 模型 |
| 问题摘要 | CodeLlama 模型 |
| 通用查询 | Llama 2 模型 |
总结
MCP 开发代理通过整合多种工具和服务，为开发者提供了高效、智能的辅助功能。无论是代码分析、文档搜索还是版本控制，该工具都能显著提升开发效率和体验。
开始使用 MCP 开发代理，优化您的开发流程！