JinDaGe - protocols-io-mcp-server MCP Details

article

README

🚀 Protocols.io MCP Server

Protocols.io MCP 服务器是一个模型上下文协议（MCP）服务器，它能让像 Claude Desktop 这样的 MCP 客户端与 protocols.io 进行交互。protocols.io 是一个广受欢迎的用于分享科学实验方案和方法的平台。

🚀 快速开始

本服务器提供以下工具供 MCP 客户端使用。在使用前，请确保满足以下要求：

Python 3.10 或更高版本
拥有具备 API 访问令牌的 protocols.io 账户
安装 MCP 客户端（例如 Claude Desktop）

✨ 主要特性

搜索与检索

search_public_protocols - 通过关键词搜索公开的实验方案
get_protocol - 通过 ID 获取实验方案的基本信息
get_protocol_steps - 获取特定实验方案的详细步骤
get_my_protocols - 检索你账户下的所有实验方案

实验方案创建与管理

create_protocol - 创建带有标题和描述的新实验方案
update_protocol_title - 更新现有实验方案的标题
update_protocol_description - 更新现有实验方案的描述

步骤管理

set_protocol_steps - 替换实验方案中的所有步骤
add_protocol_step - 在实验方案末尾添加单个步骤
delete_protocol_step - 从实验方案中删除特定步骤

📦 安装指南

使用 Docker 快速启动

docker run -d -p 8000:8000 -e PROTOCOLS_IO_CLIENT_ACCESS_TOKEN="your_access_token_here" --name protocols-io-mcp --restart always ghcr.io/hqn21/protocols-io-mcp:latest

使用 pip 安装包

pip install protocols-io-mcp

📚 详细文档

配置

环境变量

在运行服务器或测试之前，你必须设置 protocols.io 的 API 访问令牌：

export PROTOCOLS_IO_CLIENT_ACCESS_TOKEN="your_client_access_token"

要获取 API 令牌，请按以下步骤操作：

访问 protocols.io/developer
登录你的账户
进入 API 客户端部分并添加新客户端
复制生成的客户端访问令牌并在环境中设置

使用方法

命令行界面

使用各种传输选项运行 MCP 服务器：

# 默认：标准输入输出传输（推荐用于 MCP 客户端）
protocols-io-mcp

# HTTP 传输
protocols-io-mcp --transport http --host 127.0.0.1 --port 8000

# 服务器发送事件传输
protocols-io-mcp --transport sse --host 127.0.0.1 --port 8000

CLI 选项

Usage: protocols-io-mcp [OPTIONS]

  Run the protocols.io MCP server.
    
Options:
  --transport [stdio|http|sse]  Transport protocol to use [default: stdio]
  --host TEXT                   Host to bind to when using http and sse
                                transport [default: 127.0.0.1]
  --port INTEGER                Port to bind to when using http and sse
                                transport [default: 8000]
  --help                        Show this message and exit.

与 Claude Desktop 集成

要在 Claude Desktop 中使用此服务器，请在 claude_desktop_config.json 中添加以下配置：

{
  "mcpServers": {
    "protocols-io": {
      "command": "protocols-io-mcp",
      "env": {
        "PROTOCOLS_IO_CLIENT_ACCESS_TOKEN": "your_client_access_token"
      }
    }
  }
}

故障排除

MCP protocols-io: spawn protocols-io-mcp ENOENT

此错误表明 Claude Desktop 找不到 protocols-io-mcp 命令。要解决此问题：

确保你已使用 pip 全局安装了 protocols-io-mcp 包。
将 claude_desktop_config.json 中的 command 字段更改为 protocols-io-mcp 可执行文件的完整路径。你可以通过运行以下命令找到该路径：
```
which protocols-io-mcp
```

最终配置应如下所示：

{
  "mcpServers": {
    "protocols-io": {
      "command": "/full/path/to/protocols-io-mcp",
      "env": {
        "PROTOCOLS_IO_CLIENT_ACCESS_TOKEN": "your_client_access_token"
      }
    }
  }
}

开发

运行测试

确保你已设置 PROTOCOLS_IO_CLIENT_ACCESS_TOKEN 环境变量，然后运行：

pytest

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

protocols-io-mcp-server