模型上下文协议服务器

一个基于FastAPI构建的模型上下文协议服务器,支持模型交互、外部API通信和AI驱动处理,可部署在云端或本地。

  • by HydroTekFarm2023
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 HydroTekFarm2023/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中的命令来测试您的服务器。