Protocols Io MCP Server

一个基于Model Context Protocol的服务器，提供与protocols.io科学实验协议平台交互的工具，包括协议搜索、创建、管理和步骤操作等功能。

研究与数据教育与学习工具 #科学协议 #实验管理 #API集成 .Python

评分 : 2.5分

下载量 : 0

更新时间 : 2025-09-09

打开站点

什么是Protocols.io MCP Server?

这是一个专门为AI助手设计的连接服务器，让AI能够直接与protocols.io平台交互。protocols.io是一个流行的科学实验协议共享平台，研究人员可以在这里发布、分享和查找各种实验方法。通过这个MCP服务器，AI助手可以帮助您搜索实验协议、查看详细步骤、甚至创建和管理您自己的实验流程。

如何使用Protocols.io MCP Server?

首先需要获取protocols.io的API访问令牌，然后在AI助手（如Claude Desktop）中配置服务器连接。配置完成后，您就可以直接通过自然语言与AI交流，让它帮您查找实验方法、管理实验步骤或创建新的实验协议。

适用场景

适合科研人员、实验室助理、学生等需要频繁查阅或创建实验方法的用户。无论是寻找特定的实验protocol、整理实验步骤，还是需要AI协助编写实验流程，这个工具都能提供很大帮助。

主要功能

公共协议搜索

通过关键词搜索protocols.io平台上的公开实验协议，快速找到所需的研究方法

协议详情查看

获取特定实验协议的完整信息，包括标题、描述和详细的步骤说明

个人协议管理

访问和管理您个人账户中的所有实验协议，方便集中查看和编辑

创建新协议

直接通过AI助手创建新的实验协议，设置标题和描述信息

步骤管理

添加、删除或替换实验协议中的具体步骤，完善实验流程

协议更新

修改现有协议的标题和描述，保持实验信息的最新状态

优势

无缝集成：与Claude等AI助手完美集成，通过自然语言即可操作

节省时间：快速搜索和获取实验方法，避免手动浏览网站

便捷管理：直接通过AI管理个人实验协议，提高工作效率

多协议支持：支持HTTP、SSE和Stdio多种传输协议，适应不同环境

局限性

需要API令牌：使用前必须申请protocols.io的API访问权限

依赖网络：需要稳定的网络连接来访问protocols.io服务

功能限制：某些高级功能可能受protocols.io API限制

配置要求：需要一定的技术知识进行初始配置

如何使用

获取API访问令牌

访问protocols.io开发者页面，登录您的账户，创建新的API客户端并复制生成的访问令牌

设置环境变量

将获取的访问令牌设置为系统环境变量，以便服务器能够访问

安装服务器

通过pip安装MCP服务器包，或者使用Docker容器快速部署

配置AI客户端

在Claude Desktop等MCP客户端中添加服务器配置，指定命令路径和环境变量

使用案例

查找分子生物学实验方法

研究人员需要快速找到PCR实验的标准操作流程

创建新的实验记录

实验室助理需要记录一个新开发的实验方法

管理实验步骤

需要为现有实验协议添加详细的操作步骤

常见问题

如何获取protocols.io的API访问令牌？

Claude Desktop显示'spawn protocols-io-mcp ENOENT'错误怎么办？

支持哪些传输协议？

是否需要付费才能使用？

可以搜索私有协议吗？

🚀 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"
      }
    }
  }
}