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許可證。