MCP Sse Langchain Example

🚀 基於SSE傳輸的MCP多服務器演示

本項目展示瞭如何運用模型上下文協議（Model Context Protocol, MCP）與多個服務器協作，採用了標準輸入輸出和服務器發送事件這兩種不同的傳輸方式。項目基於示例：https://github.com/langchain-ai/langchain-mcp-adapters 構建。

🚀 快速開始

本項目能讓你體驗使用MCP與多服務器通信的流程，以下是快速上手步驟：

1. 確保滿足系統要求：Python 3.8+ 以及擁有 OpenAI API 密鑰。
2. 按照安裝指南完成項目的安裝與配置。
3. 運行主應用程序，即可開始體驗項目功能。

✨ 主要特性

• 多服務器協作：項目包含數學服務器和天氣服務器，主應用程序可連接這兩個服務器並進行通信。
• 不同傳輸方式：數學服務器採用標準輸入輸出傳輸，天氣服務器採用服務器發送事件（SSE）傳輸。
• 集成第三方工具：集成了 LangChain 和 OpenAI，創建的代理能夠調用兩個服務器提供的工具。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/mcp-sse.git
cd mcp-sse

安裝依賴

pip install -r requirements.txt

設置 API 密鑰

在 .env 文件中設置 OpenAI API 密鑰：

OPENAI_API_KEY=your-api-key-here

💻 使用示例

基礎用法

運行主應用程序：

python main.py

這將完成以下操作：

1. 在端口 8000 啟動天氣服務器。
2. 連接到數學和天氣服務器。
3. 運行代理並演示兩個示例查詢的處理。

示例查詢

本演示包含以下兩個示例查詢：

1. 數學查詢："what's (3 + 5) x 12?"
2. 天氣查詢："what is the weather in nyc?"

📚 詳細文檔

項目結構

• main.py：主應用程序，負責連接兩個服務器並運行代理。
• math_server.py：一個簡單的 MCP 服務器，使用標準輸入輸出傳輸提供算術運算服務。
• weather_server.py：一個簡單的 MCP 服務器，使用 SSE 傳輸提供天氣信息服務。
• requirements.txt：Python 依賴項列表。
• .env：環境變量文件（包含 OpenAI API 密鑰）。

工作原理

應用程序演示瞭如何使用 MultiServerMCPClient 連接到多個採用不同傳輸協議的 MCP 服務器：

1. 數學服務器使用標準輸入輸出（stdio）傳輸，這是一種基於管道的簡單通信方法。
2. 天氣服務器使用服務器發送事件（SSE）傳輸，這是一種用於 HTTP 協議中服務器向客戶端推送通知的機制。

主應用程序的工作流程如下：

1. 作為獨立進程啟動天氣服務器。
2. 使用 MultiServerMCPClient 連接到兩個服務器。
3. 創建 LangChain 代理，該代理能夠調用兩個服務器提供的工具。
4. 演示使用代理執行算術計算和獲取天氣信息的能力。

擴展項目

你可以通過以下方式擴展該項目：

1. 向數學或天氣服務器添加更多功能。
2. 創建具有不同功能的其他 MCP 服務器。
3. 修改代理以處理更復雜的查詢。
4. 使用真實的天氣 API 代替模擬數據。

📄 許可證

本項目採用 MIT 許可證。

致謝

• 該項目使用了模型上下文協議（MCP），此協議由 Anthropic 開發。
• 集成了 LangChain 用於代理功能。