Orcid MCP

orcid mcp

用于ORCID集成的模型上下文协议（MCP）服务器。该服务器提供通过MCP接口与ORCID记录交互的工具。

特性

• 按ID获取ORCID记录
• 使用MCP SDK使用Go构建

先决条件

• 转到1.20或更高版本
• ORCID API承载令牌

安装

make build

这将构建 orcid-mcp-local-server 二进制在 bin/ 目录。

ORCID API设置

注册API证书

1. 访问 ORCID开发工具
2. 登录您的ORCID帐户并导航到开发人员工具
3. 点击“注册免费ORCID公共API”
4. 填写注册表：

- 应用程序名称: Personal ORCID MCP Server （或类似） - 应用程序URL：您的机构URL或 https://orcid.org - 应用描述: Personal MCP server for accessing ORCID records - 重定向URI: https://orcid.org/oauth/playground

1. 保存表格以接收您的 客户端ID 和 客户端密钥

获取不记名代币

使用客户端凭据流将您的凭据交换为承载令牌：

curl -i -L -H 'Accept: application/json' \
  -d 'client_id=YOUR_CLIENT_ID' \
  -d 'client_secret=YOUR_CLIENT_SECRET' \
  -d 'scope=/read-public' \
  -d 'grant_type=client_credentials' \
  'https://orcid.org/oauth/token'

用于沙盒测试，使用 https://sandbox.orcid.org/oauth/token 相反。

响应将包含您的持有者令牌：

{
  "access_token": "your-bearer-token-here",
  "token_type": "bearer",
  "expires_in": 631138518,
  "scope": "/read-public"
}

配置环境

将承载令牌设置为环境变量：

export ORCID_BEARER_TOKEN="your-access-token-here"

对于持久配置，请添加到shell配置中(~/.bashrc, ~/.zshrc等等）：

# ORCID MCP Server
export ORCID_BEARER_TOKEN="your-access-token-here"

用法

发展

make run                # Run the server
make inspect           # Test with MCP inspector

Claude桌面集成

将服务器添加到您的Claude Desktop配置中：

1. 编辑Claude Desktop配置文件：

- Linux: ~/.config/Claude/claude_desktop_config.json - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 将ORCID MCP服务器添加到 mcpServers 章节：

{
  "mcpServers": {
    "orcid-mcp": {
      "type": "stdio",
      "command": "/absolute/path/to/orcid-mcp/bin/orcid-mcp-local-server",
      "args": [],
      "env": {
        "ORCID_BEARER_TOKEN": "your-bearer-token-here"
      }
    }
  }
}

1. 替换 /absolute/path/to/orcid-mcp/bin/orcid-mcp-local-server 带有编译二进制文件的实际路径
2. 替换 your-bearer-token-here 使用API设置中的实际承载令牌
3. 重新启动Claude Desktop应用程序

Claude代码集成

make cc-add-mcp        # Add to Claude Code (project scope)
make cc-remove-mcp     # Remove from Claude Code

对于用户范围的Claude Code访问：

claude mcp add orcid-mcp-local-server --scope user -- /path/to/orcid-mcp/bin/orcid-mcp-local-server

注意：您可能需要手动添加 ORCID_BEARER_TOKEN 将环境变量添加到生成的配置文件中。

可用工具

• 获取ORCID记录：按ID检索ORCID记录

测试

make test

备注

• /read-public 作用域提供对公共ORCID数据的只读访问
• 令牌的寿命很长（读取公共范围约为20年）
• 客户端凭据流不需要用户授权
• 生产终点： https://orcid.org/oauth/token
• 沙盒端点： https://sandbox.orcid.org/oauth/token

安全

• 切勿将您的承载令牌或客户端凭据提交给版本控制
• 添加 .env 文件和凭据 .gitignore
• 考虑定期重新生成API凭据
• 使用环境变量或安全密钥管理进行生产部署