项目说明

安装指南

环境要求

• 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。

注意事项

1. API 密钥安全：

   • 将 .env 文件添加到 .gitignore 中，避免泄露敏感信息。
   • 检查 .env.example 文件以获取所需环境变量。

2. 模块化设计：

   • 可根据需要禁用特定服务，默认情况下所有功能均启用。

3. 语言包版本控制：

   • 使用 langgraph-prebuilt==0.1.5 以确保兼容性。
   • 更新依赖前，请进行充分测试，避免版本不兼容问题。

许可证

本项目采用 MIT 协议开源。

组件详细信息

create_react_agent 导入路径

在代码中使用正确的导入方式：

from langgraph.prebuilt.task import create_react_agent

注意：请勿使用以下旧式导入，否则会导致错误：

from langgraph.prebuilt import create_react_agent