Langchain MCP Chat Platform

🚀 項目說明

本項目是一個集成了多種服務的應用平臺，提供了自然語言處理、網頁搜索、郵件管理等功能。通過簡單的配置和安裝，用戶可以快速啟動並使用這些服務。

🚀 快速開始

按照以下步驟，你可以快速啟動本項目：

1. 完成環境配置和依賴安裝。
2. 配置必要的環境變量。
3. 選擇合適的啟動方案啟動應用。

📦 安裝指南

環境要求

• Python：建議使用 Python 3.8 或更高版本。
• Node.js：需要 Node.js 和 npm（僅用於啟動 Tavily 和 Gmail 服務）。

安裝依賴項

在 web_js 目錄中安裝必要的 Python 包：

pip install -r requirements.txt

🛠️ 配置

環境變量

創建一個名為 .env 的文件，並添加以下內容，替換為你的實際 API 密鑰：

GOOGLE_API_KEY=your_api_key_here
SMITHERY_KEY=your_smithery_cli_key_here
TAVILY_API_KEY=your_tavily_api_key_here  # 可選，默認使用 SMITHKEY 環境變量
GMAIL_API_KEY=your_gmail_api_key_here    # 可選，默認使用 Gmail API 密鑰文件路徑

▶️ 啟動應用

方案一：啟動所有 MCP 服務

運行以下命令以啟用所有功能（包括 muhasebe、Tavily 搜索和 Gmail）：

cd web_js
python main.py

方案二：僅啟動 muhasebe 服務（推薦首次使用）

為了初始測試，可以註釋掉 web_js/main.py 中的 Tavily 和 Gmail 服務配置。

🚑 故障排除

應用啟動時卡頓

• 問題：應用在啟動過程中無響應。
• 解決方法：
  1. 僅啟動 muhasebe 服務以測試基本功能。
  2. 確保 Node.js 和 npm 已正確安裝，並運行 npm install -g @smithery/cli。

路徑問題

• 問題：找不到 MCP 服務器路徑。
• 解決方法：在 web_js/main.py 中使用絕對路徑啟動 MCP 服務，例如：

  "args": ["C:/full/path/to/langchain-mcp-chat-platform/own_mcp/mcp_server.py"]
  

🌐 第三方集成功能

Google Gemini

• 用途：自然語言理解與生成。
• 配置：確保 GOOGLE_API_KEY 正確設置。

Tavily

• 用途：網頁搜索與內容提取。
• 配置：在 .env 中指定 TAVILY_API_KEY 或使用環境變量 SMITHKEY。

Gmail

• 用途：電子郵件操作與管理。
• 配置：啟用 Google Cloud 項目中的 Gmail API，並設置 GMAIL_API_KEY。

⚠️ 注意事項

⚠️ 重要提示

• 將 .env 文件添加到 .gitignore 中，避免洩露敏感信息。
• 檢查 .env.example 文件以獲取所需環境變量。

💡 使用建議

• 本項目採用模塊化設計，可根據需要禁用特定服務，默認情況下所有功能均啟用。
• 使用 langgraph-prebuilt==0.1.5 以確保兼容性，更新依賴前，請進行充分測試，避免版本不兼容問題。

📄 許可證

本項目採用 MIT 協議開源。

📚 組件詳細信息

create_react_agent 導入路徑

在代碼中使用正確的導入方式：

from langgraph.prebuilt.task import create_react_agent

注意：請勿使用以下舊式導入，否則會導致錯誤：

from langgraph.prebuilt import create_react_agent