MCP Basic Architecture

🚀 LangGraph MCP 服務器

LangGraph MCP 服務器是一個乾淨、模塊化實現的服務器，用於處理 LangGraph 文檔中的 Model Context Protocol (MCP)。它能高效解決 MCP 相關任務，為用戶提供穩定、可擴展的服務。

🚀 快速開始

要運行服務器，只需執行以下命令：

python -m app.server

✨ 主要特性

• 模塊化設計：每個組件都有單一職責，便於維護和擴展。
• 可擴展性強：能輕鬆添加新工具和資源，而無需修改現有代碼。
• 易於維護：採用清潔架構模式，組織良好的結構使調試更加容易。
• 可測試性高：組件可以在隔離中進行測試，確保系統的穩定性。

🔧 技術細節

架構

該項目遵循清潔架構模式，以便隨著功能的增加使 MCP 服務器更易於維護和調試。

目錄結構

app/
├── config.py                  # 配置設置
├── server.py                  # 主服務器入口點
├── resources/                 # 客戶端可以訪問的資源
│   ├── __init__.py            # 資源註冊
│   └── langgraph_resources.py # LangGraph特定資源
├── tools/                     # 客戶端可以調用的工具
│   ├── __init__.py            # 工具註冊
│   └── langgraph_tools.py     # LangGraph特定工具
└── utils/                     # 全應用中使用的公用函數
    ├── __init__.py
    └── logging_utils.py       # 記錄日誌的實用程序

核心組件

1. 服務器：主入口點，初始化 MCP 服務器並註冊所有工具和資源。
2. 配置：所有配置設置的集中位置。
3. 工具：客戶端可以調用以執行特定任務的功能函數。
4. 資源：客戶端可以訪問的數據源。
5. 公用程序：在應用程序中使用的實用函數。

💻 使用示例

基礎用法

添加新工具

1. 在app/tools/目錄中創建一個新的文件（例如，weather_tools.py）。
2. 在此文件中定義您的工具函數。
3. 創建一個註冊函數（例如，register_weather_tools）。
4. 將此註冊函數導入並在app/tools/__init__.py中調用。

示例：

# app/tools/weather_tools.py
def register_weather_tools(mcp):
    mcp.tool()(get_weather)

def get_weather(city: str):
    """獲取某個城市的天氣"""
    # 實現細節
    return f"{city}的天氣：晴朗，75°F"

添加新資源

1. 在app/resources/目錄中創建一個新的文件（例如，weather_resources.py）。
2. 在此文件中定義您的資源函數。
3. 創建一個註冊函數（例如，register_weather_resources）。
4. 將此註冊函數導入並在app/resources/__init__.py中調用。

示例：

# app/resources/weather_resources.py
def register_weather_resources(mcp):
    mcp.resource("weather://forecast")(get_weather_forecast)

def get_weather_forecast():
    """獲取天氣預報"""
    # 實現細節
    return "5天天氣預報數據"