Zenodo MCP Server

zenodo mcp服务器

允许LLM代理查询和交互的MCP服务器 泽诺多 使用 Zenodo REST API.

特性

• 未经身份验证的访问 –在没有API密钥的情况下搜索和检查公共记录
• 会话API密钥 –在运行时通过以下方式提供个人访问令牌 set_api_key 工具
• 持久服务帐户 –设置 ZENODO_API_KEY 长期密钥的环境变量
• 可选写访问 –创建、更新和发布证词（通过启用 ZENODO_ALLOW_WRITE=true)
• 使用完整的Elasticsearch查询语法、分页和过滤搜索记录
• 浏览和过滤Zenodo社区
• 检索记录元数据、文件和文件内容（文本或二进制）
• 列出、创建、更新、发布和版本证词（需要编写工具 ZENODO_ALLOW_WRITE=true)
• 沙箱或自托管实例的可配置Zenodo基本URL
• 可选的默认社区过滤器 ZENODO_COMMUNITY

快速开始

先决条件

• Node.js 18或更高版本
• npm

安装

git clone https://github.com/eic/zenodo-mcp-server.git
cd zenodo-mcp-server
npm install
npm run build

运行服务器

# Without authentication (public records only)
node build/src/index.js

# With a persistent API key (service account)
ZENODO_API_KEY=your_token node build/src/index.js

# Against the Zenodo sandbox
ZENODO_BASE_URL=https://sandbox.zenodo.org ZENODO_API_KEY=your_sandbox_token node build/src/index.js

认证

Zenodo使用 个人访问令牌 用于身份验证。

选项1–会话密钥（建议交互式使用）

连接到服务器后，调用 set_api_key 工具：

{ "name": "set_api_key", "arguments": { "api_key": "your_personal_access_token" } }

令牌在服务器进程的生命周期内存储在内存中，永远不会写入磁盘。

选项2——环境变量（服务帐户/CI）

export ZENODO_API_KEY=your_personal_access_token
node build/src/index.js

创建令牌

1. 登录到 zenodo.org
2. 首选 账户→ 设置→ 应用程序→ 个人访问令牌
3. 点击 新代币 并选择所需的范围：

- deposit:write –创建和更新证词 - deposit:actions –公布证词 - user:email –验证身份（可选）

1. 安全地保存令牌——它只显示一次

可用工具

写入工具仅在以下情况下可用 ZENODO_ALLOW_WRITE=true （或 ZENODO_ALLOW_WRITE=1)已设置。看 docs/TOOLS.md 有关完整参数的详细信息。

search_records

{
  "name": "search_records",
  "arguments": {
    "query": "electron ion collider",
    "size": 10,
    "page": 1,
    "sort": "mostrecent",
    "type": "publication",
    "subtype": "article",
    "communities": "zenodo",
    "all_versions": false,
    "bounds": "143.37,-38.99,146.90,-37.35"
  }
}

排序选项： bestmatch, mostrecent, mostviewed, mostdownloaded （前缀 - 下降）。

资源类型： publication, poster, presentation, dataset, image, video, software, lesson, other.

bounds --可选的地理定位边界框： "west,south,east,north" 以十进制度数表示。

当 ZENODO_COMMUNITY 已设置 communities 如果没有提供，参数默认为该值。

get_record

接受数字ID或DOI：

{ "name": "get_record", "arguments": { "id": "1234567" } }
{ "name": "get_record", "arguments": { "id": "10.5281/zenodo.1234567" } }

get_file_content

{
  "name": "get_file_content",
  "arguments": {
    "id": "1234567",
    "filename": "data.csv",
    "max_bytes": 1048576
  }
}

文本文件以UTF-8字符串的形式返回。二进制文件以base64格式返回。这 truncated 字段指示文件是否在 max_bytes.

环境变量

MCP客户端配置

将服务器添加到MCP客户端配置中（例如Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "zenodo": {
      "command": "node",
      "args": ["/path/to/zenodo-mcp-server/build/src/index.js"],
      "env": {
        "ZENODO_API_KEY": "your_token_here"
      }
    }
  }
}

发展

npm run build        # Compile TypeScript
npm run watch        # Watch mode
npm test             # Build and run tests
npm run test:coverage  # Tests with coverage report

许可证

麻省理工学院