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
}

模型選擇與任務分配

總結

MCP 開發代理通過整合多種工具和服務，為開發者提供了高效、智能的輔助功能。無論是代碼分析、文檔搜索還是版本控制，該工具都能顯著提升開發效率和體驗。

開始使用 MCP 開發代理，優化您的開發流程！