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