LangGraph MCP Server

LangGraph MCP 服务

一个用于 LangGraph 文档的简洁、模块化 Model Context Protocol（MCP）服务实现。

架构

本项目采用整洁架构模式，使 MCP 服务更易于维护，并在添加更多功能时更易于调试。

目录结构

app/
├── config.py                  # Configuration settings
├── server.py                  # Main server entry point
├── resources/                 # Resources that can be accessed by clients
│   ├── __init__.py            # Resource registration
│   └── langgraph_resources.py # LangGraph-specific resources
├── tools/                     # Tools that can be called by clients
│   ├── __init__.py            # Tool registration
│   └── langgraph_tools.py     # LangGraph-specific tools
└── utils/                     # Utility functions
    ├── __init__.py
    └── logging_utils.py       # Logging utilities

核心组件

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):
    """Get weather for a city"""
    # Implementation
    return f"Weather for {city}: Sunny, 75°F"

# app/tools/__init__.py
from app.tools.langgraph_tools import register_langgraph_tools
from app.tools.weather_tools import register_weather_tools

def register_tools(mcp):
    register_langgraph_tools(mcp)
    register_weather_tools(mcp)

添加新资源

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():
    """Get weather forecast"""
    # Implementation
    return "5-day weather forecast data"

# app/resources/__init__.py
from app.resources.langgraph_resources import register_langgraph_resources
from app.resources.weather_resources import register_weather_resources

def register_resources(mcp):
    register_langgraph_resources(mcp)
    register_weather_resources(mcp)

运行服务

运行服务：

python -m app.server

此架构的优势

1. 模块化：每个组件都只有一个职责。
2. 可扩展性：无需修改现有代码，即可轻松添加新工具和资源。
3. 可维护性：结构清晰，便于调试。
4. 可伸缩性：随着功能增加，也能应对增长需求。
5. 可测试性：可以单独测试各个组件。