mcp-dev-agent

🚀 MCP 开发代理

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

🚀 快速开始

MCP 开发代理为开发者提供了高效、智能的辅助功能，能显著提升开发效率和体验。你可以按照以下步骤开始使用：

1. 参考“📦 安装指南”完成工具的安装与配置。
2. 依据“💻 使用指南”中的命令和示例，开启 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 开发代理，优化您的开发流程！