Langgraph Coding Team

🚀 協作編碼機器人項目

本項目是一個結合了 LangGraph 和 Model Context Protocol（MCP）的協作編碼機器人。該系統由三部分構成，分別是一個 gateway server、多個 MCP servers 以及三個協作的 Coding Agents，能有效提升編碼協作效率。

🚀 快速開始

1. 安裝依賴項

# 安裝代理包
pip install -e .

# 安裝網關包
cd gateway
pip install -e .
cd ..

2. 配置環境變量

支持通過環境變量使用多個 LLM 提供商：

# LLM 配置 - 支持多個提供方：
LLM_MODEL=provider/model-name

# 支持的提供方和示例模型：
# - Anthropic: anthropic/claude-3-5-sonnet-20240620
# - OpenAI: openai/gpt-4
# - OpenRouter: openrouter/openai/gpt-4o-mini
# - Google: google/gemini-1.5-pro

# 不同提供方的 API Key
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
GOOGLE_API_KEY=your_google_api_key

# OpenRouter 配置（如果使用 OpenRouter）
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

3. 配置 MCP 服務器

網關服務器通過 gateway/config.json 進行配置。默認啟動兩個 MCP 服務器：

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-filesystem",
          "/path/to/directory"
        ]
      },
      "memory": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-memory"
        ]
      }
    }
  }
}

可以在 官方 MCP 服務器倉庫 中添加更多服務器。

4. 啟動網關服務器

cd gateway
python -m mcp_gateway.server

服務器將在默認端口 8808 上啟動。

5. 配置代理

代理與網關的連接在 langgraph.json 中配置：

{
  "dependencies": ["."],
  "graphs": {
    "agent": "./src/react_agent/graph.py:graph"
  },
  "env": ".env",
  "mcp": {
    "gateway_url": "http://localhost:8808"
  }
}

6. 使用代理

在 LangGraph Studio 中打開文件夾！代理將自動：

1. 連接到網關
2. 發現可用工具
3. 開始協作編碼

✨ 主要特性

MCP Gateway Server

• 管理多個 MCP server 實例。
• 提供統一 API 接口訪問工具。
• 處理與 MCP 服務器的通信。
• 通過簡單 HTTP 接口暴露工具。

MCP Servers

• 特定功能的服務器：
  • GitHub 服務器：支持倉庫操作（讀寫、列表、搜索、創建分支、創建 PR 等）。
  • 可添加更多服務器以擴展功能。

Coding Agents

• Orchestrator：從人類信息中收集上下文並使用 MCP 服務器訪問 Linear 和 GitHub。根據需要委託 Planner 和 Coder。
• Planner：接收需求和代碼上下文，制定計劃並提出多個實現建議。不使用 MCP。
• Coder：接收代碼上下文和擬議的實現，並在不同的 GitHub 分支上實施所有內容。

💻 使用示例

基礎用法

在 LangGraph Studio 中打開項目文件夾，代理會自動連接網關、發現工具並開始協作編碼。

📦 安裝指南

見快速開始部分的安裝依賴項、配置環境變量、配置 MCP 服務器、啟動網關服務器、配置代理等步驟。

📚 詳細文檔

更多詳細信息請參考：

• LangGraph 官方文檔
• MCP 協議文檔

🔧 技術細節

本系統結合了 LangGraph 和 MCP，通過 MCP Gateway Server 管理多個 MCP servers，實現工具的統一訪問和通信。Coding Agents 中的 Orchestrator、Planner 和 Coder 協作完成編碼任務。通過環境變量配置支持多個 LLM 提供商，可靈活選擇不同的大語言模型。同時，可通過配置文件添加新的 MCP 服務器和自定義代理行為，方便系統擴展和定製。

📄 許可證

項目使用 MIT 許可證，詳情見 LICENSE 文件。

🛠️ 開發指南

添加新服務器

在 config.json 中添加新的 MCP 服務器配置，然後重新啟動網關。

自定義代理

可以通過修改 graph.py 和相關組件來自定義代理的行為。

🛠️ 可用工具

Filesystem Tools

• 文件讀取
• 文件寫入
• 目錄遍歷
• 文件刪除
• 文件複製

Memory Tools

• 上下文存儲
• 會話管理
• 數據持久化
• 歷史記錄查詢