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天天气预报数据"

这种架构的优点

1. 模块化：每个组件都有单一职责。
2. 可扩展性：添加新工具和资源而不修改现有代码很容易。
3. 维护性：组织良好的结构使调试更容易。
4. 可扩展性：可以处理随着更多功能被添加的增长。
5. 测试性：组件可以在隔离中进行测试。