JinDaGe - langchain-mcp-chat-platform MCP Details

article

README

🚀 项目说明

本项目是一个集成了多种服务的应用平台，提供了自然语言处理、网页搜索、邮件管理等功能。通过简单的配置和安装，用户可以快速启动并使用这些服务。

🚀 快速开始

按照以下步骤，你可以快速启动本项目：

完成环境配置和依赖安装。
配置必要的环境变量。
选择合适的启动方案启动应用。

📦 安装指南

环境要求

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

langchain-mcp-chat-platform