Langchain Agent With MCP Servers

🚀 使用MCP服务器的LangChain智能体

本项目构建了一个利用MCP适配器与Model Context Protocol（MCP）服务器集成的LangChain智能体，能借助MCP协议与多种服务交互，为用户提供网络搜索、天气查询、数学计算等功能。

🚀 快速开始

安装

# 克隆仓库
git clone https://github.com/yourusername/langchain-mcp.git
cd langchain-mcp

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

# 安装依赖
pip install -e .

配置

在项目根目录中创建一个.env文件，并添加以下变量：

OPENAI_API_KEY=你的OpenAI API密钥
TAVILY_API_KEY=你的Tavily API密钥

运行

从命令行运行智能体：

python src/agent.py

智能体会提示输入查询，然后使用适当的工具进行处理。

✨ 主要特性

• 优雅关闭机制：所有MCP服务器实现完善的信号处理以确保干净终止。
• 子进程管理：主智能体跟踪和管理所有MCP服务器子进程。
• 错误处理：整个应用程序中具有强大的错误处理功能。
• 模块化设计：易于扩展，添加新的MCP服务器。

🔧 技术细节

优雅关闭机制

该项目实现了一个全面的优雅关闭系统：

1. 信号处理：捕获SIGINT和SIGTERM信号以启动优雅关闭。
2. 进程跟踪：主智能体维护所有子进程的注册表。
3. 清理过程：确保在退出时终止所有子进程。
4. 关闭标志：每个MCP服务器都有一个关闭标志，以防止在关闭期间执行新的操作。
5. 异步协作：使用asyncio允许进行中的操作尽可能完成。

🛠️ 开发指南

要添加新的MCP服务器：

1. 在src/mcpserver/中创建一个新的文件。
2. 实现该服务器，并带有完善的信号处理。
3. 更新src/mcpserver/__init__.py以暴露新的服务器。
4. 将新服务器配置添加到src/agent.py。

📄 许可证

本项目采用MIT许可证。