AI导哈

ORCID记录查询服务

通过MCP接口与ORCID记录交互的服务，提供获取ORCID记录的功能。

  • by Epistemic-Technology
  • Makefile
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Epistemic-Technology/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
  5. 保存表格以接收您的 客户端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

  2. 将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凭据
  • 使用环境变量或安全密钥管理进行生产部署

相关 MCP