Disease Detection MCP Server

MCP服务器部署指南

此存储库包含 MCP（模型上下文协议）服务器 建造于 快速API.\ 它支持基于模型的交互、外部API通信和人工智能驱动的处理。

您可以在中部署此服务器 两种方式:

• 使用云部署 铁路
• 通过以下方式进行本地部署 克劳德桌面版

______________________________________________________________________

先决条件

• python 3.10+
• A. 铁路 帐户（用于云部署）
• 克劳德桌面版 已安装（用于本地MCP部署）
• requirements.txt 已安装依赖项

______________________________________________________________________

环境变量

创建一个 .env 文件（或通过铁路仪表板设置）：

DYNAMODB_TABLE_NAME=your-dynamo-db-name
S3_BUCKET_NAME=your-s3-bucket-name
AWS_REGION=your-aws-region
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-access-key

对于Claude Desktop本地部署，可以通过MCP配置添加环境变量。

______________________________________________________________________

部署选项1：铁路（云托管）

1. 上传或连接您的存储库

• 将您的项目推送到GitHub。
• 首选 铁路仪表板.
• 点击 “新项目”→ “从GitHub回购部署”.
• 选择您的MCP服务器存储库。

2. 设置环境变量

在铁路→ 设置→ 变量，添加您的所有密钥 .env.

3. 配置启动命令

如果铁路没有自动检测到它，请手动设置：

uvicorn app.main:app --host 0.0.0.0 --port $PORT

4. 部署！

单击“立即部署”，Railway将构建并托管您的MCP服务器。

一旦上线，您将获得一个公共URL：

https://your-mcp-server.up.railway.app/

5. 测试部署

curl https://your-mcp-server.up.railway.app/

预期响应：

{"message":"Plant Disease MCP API running......."}

______________________________________________________________________

部署选项2:Claude桌面（本地MCP）

1. Claude桌面设置

• 首先，确保您安装了Claude for Desktop。 您可以在此处安装最新版本.
• 如果您已经拥有Claude for Desktop，请确保它已更新到最新版本。
• 我们需要为您想要使用的任何MCP服务器配置Claude for Desktop。
• 为此，请在以下位置打开Claude for Desktop App配置 ~/Library/Application Support/Claude/claude_desktop_config.json 在文本编辑器中。
• 如果文件不存在，请确保创建该文件。

macOS/Linux：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

code $env:AppData\Claude\claude_desktop_config.json

2. 添加MCP服务器

然后，您将在 mcpServers 钥匙。如果至少有一台服务器配置正确，MCP UI元素将仅显示在Claude for Desktop中。

macOS/Linux：

{
  "mcpServers": {
    "server-name": {
      "command": "package-installer",     # uv/pip
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-folder",
        "run",
        "server-file.py"
      ]
    }
  }
}

窗户：

{
  "mcpServers": {
    "server-name": {
      "command": "package-installer",     #uv/pip
      "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\mcp-folder",
        "run",
        "server-file.py"
      ]
    }
  }
}

您可能需要在命令字段中输入uv可执行文件的完整路径。你可以通过跑步来获得这个 which uv / which pip 在macOS/Linux或 where uv / where pip 在Windows上。

此消息克劳德桌面：

1. 有一个名为“服务器名称”的MCP服务器
2. 通过运行来启动它 uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-folder run server-file.py

保存文件，然后重新启动Claude for Desktop。

3. 使用命令进行测试

• 确保Claude for Desktop正在使用我们在您的 server-name。您可以通过查找 Search and tools 偶像。
• 单击滑块图标后，您应该看到列出的所有工具。
• 如果您的服务器没有被Claude for Desktop接收，请继续 故障排除 调试提示部分。
• 如果工具设置图标已显示，您现在可以通过运行Claude for Desktop中的命令来测试您的服务器。