期刊数据 MCP 服务

除 REST API 外，我们还提供 MCP（Model Context Protocol）服务，可将期刊查询能力直接接入支持 MCP 的 AI 客户端（Claude Desktop、Claude Code、Cherry Studio、Cline 等）。

接入后，你可以在对话中直接问 AI：

"帮我查一下 J Med Chem 和 Nature Communications 的影响因子和分区，顺便看看有没有预警期刊。"

AI 会自动调用工具完成查询，无需你手写任何请求。

基础信息

服务地址：https://api.byteslink.cn/journals/mcp
传输协议：Streamable HTTP（远程服务，无需本地安装）
认证：API Key，与 REST API 共用同一个 Key（pp_ 开头），在「用户中心 → 我的API」生成
计费与限流：与 REST API 完全一致，详见计费与限流

支持两种传 Key 方式，任选其一：

X-API-Key: pp_xxxxxxxxxxxxxxxx

或（部分客户端只提供 Bearer Token 输入框）：

Authorization: Bearer pp_xxxxxxxxxxxxxxxx

提供的工具

工具	功能	对应接口
`query_impact_factors`	批量查询影响因子（JIF / JIF5）、JCR 分区、中科院分区	`POST /dev/impact-factors/`
`check_warnings`	检查期刊是否在中科院《国际期刊预警名单》（2025 版）中	`POST /dev/warnings/`

两个工具入参一致：journals 期刊名列表，1–20 个，支持常见缩写（如 J Med Chem）与全称，大小写不敏感。每次工具调用计费 1 次（无论查几个期刊），批量查询更省额度。

客户端配置

Claude Code

一条命令完成接入：

bash

claude mcp add --transport http paperpop-journals \
  https://api.byteslink.cn/journals/mcp \
  --header "X-API-Key: pp_xxxxxxxx"

验证：运行 claude mcp list 应能看到 paperpop-journals，然后在对话中直接提问即可。

Claude Desktop

Claude Desktop 目前通过 mcp-remote 桥接远程 HTTP 服务（需已安装 Node.js）。编辑配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "paperpop-journals": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.byteslink.cn/journals/mcp",
        "--header", "X-API-Key: pp_xxxxxxxx"
      ]
    }
  }
}

保存后重启 Claude Desktop，在工具列表中应能看到两个期刊工具。

Cherry Studio

设置 → MCP 服务器 → 添加服务器：

类型：Streamable HTTP（可流式传输的 HTTP）
URL：https://api.byteslink.cn/journals/mcp
请求头：X-API-Key=pp_xxxxxxxx

Cline / 其他支持 Streamable HTTP 的客户端

在 MCP 配置中添加：

json

{
  "mcpServers": {
    "paperpop-journals": {
      "type": "streamableHttp",
      "url": "https://api.byteslink.cn/journals/mcp",
      "headers": {
        "X-API-Key": "pp_xxxxxxxx"
      }
    }
  }
}

不同客户端的字段名可能略有差异（如 type 取值为 http / streamable-http），以客户端文档为准；核心只有两项：URL 与 X-API-Key 请求头。

错误与提示

工具返回中若包含 error 字段，含义如下：

error	含义	处理建议
`missing_api_key`	未携带 Key	检查客户端配置中的请求头
`invalid_key`	Key 无效	去「用户中心 → 我的API」重新生成（旧 Key 会立即失效）
`quota_exhausted`	免费 + 付费额度耗尽	前往用户中心充值
`rate_limited`	触发限流	稍后退避重试
`too_many`	单次超过 20 个期刊	分批调用（每批计费 1 次）
`upstream_unreachable` / `upstream_error`	服务暂时不可用	稍后重试，持续失败请联系我们

特别说明

JCR 影响因子 / 分区数据来源于互联网公开信息，已更新至2026年6月17日最新版本。
预警名单由中国科学院文献情报中心发布（2025 版，130+ 种期刊）。
MCP 服务与 REST API 共用同一套数据、Key、额度与限流，二者查询结果一致。

常见问题

Q：MCP 和 REST API 用哪个？ 写代码做二次开发（Zotero 插件、自动化脚本）用 REST API；在 AI 对话中直接查询用 MCP。两者共用额度，随意组合。

Q：Key 会不会被 AI 模型看到？ 不会。Key 只存在于你本地的客户端配置中，随请求头发送到我们的服务器，不会进入对话内容。

Q：明文 Key 丢了怎么办？ 在「用户中心 → 我的API」重新生成即可，旧 Key 立即失效。记得同步更新各客户端配置。

期刊数据 MCP 服务 ​

基础信息 ​

提供的工具 ​

客户端配置 ​

Claude Code ​

Claude Desktop ​

Cherry Studio ​

Cline / 其他支持 Streamable HTTP 的客户端 ​

错误与提示 ​

常见问题 ​

相关链接 ​