MCP Server 配置

什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 推出的开放协议，允许 AI 模型安全地连接外部数据源和工具。Ai4Scholar 提供了 MCP Server，让你在 Claude Desktop、Claude Code、Cursor、Cherry Studio 等支持 MCP 的工具中直接搜索文献、读取全文、下载 PDF、自动补引用。

准备：获取 API Key

在 Ai4Scholar 的 开放平台 页面创建 API Key（形如 sk-user-...）。下面两种接入方式都用它鉴权。

方式一：云端连接（推荐，无需安装）

直接连接我们托管的 SSE 服务，不需要安装任何东西。

Claude Desktop

编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json，Windows: %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "ai4scholar": {
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer sk-user-your-key-here"
      }
    }
  }
}

Cursor

进入 Settings → MCP 添加服务器，或编辑项目里的 .cursor/mcp.json：

{
  "mcpServers": {
    "ai4scholar": {
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer sk-user-your-key-here"
      }
    }
  }
}

其他客户端（Cherry Studio、TRAE、ChatBox 等）在 MCP 设置里选择 SSE 类型，URL 填 https://mcp.ai4scholar.net/sse，并添加 Authorization: Bearer sk-user-your-key-here 请求头即可。

配置完成后重启客户端。

方式二：本地运行（stdio）

通过 pip 安装到本机运行。本地模式支持把 PDF 直接下载到你的电脑，在校园网环境下还能利用机构订阅权限获取付费论文。需要 Python 3.10+。

pip install ai4scholar-mcp

Claude Code 推荐用这种方式（其 SSE 模式存在已知问题）：

claude mcp add ai4scholar --scope user --transport stdio -e AI4SCHOLAR_API_KEY=sk-user-your-key-here -- python -m ai4scholar_mcp.server

Claude Desktop 本地模式配置：

{
  "mcpServers": {
    "ai4scholar": {
      "command": "python",
      "args": ["-m", "ai4scholar_mcp.server"],
      "env": {
        "AI4SCHOLAR_API_KEY": "sk-user-your-key-here"
      }
    }
  }
}

包主页见 PyPI: ai4scholar-mcp。

旧配置迁移

本页早前版本曾给出 npx -y @ai4scholar/mcp-server 的配置——该 npm 包并不存在，按那份配置无法连接。如果你之前照它配置过，删掉那段、换成本页上面任意一种方式即可。

可用工具

调用会按次消耗 Ai4Scholar 积分，价目见 积分与套餐。

使用示例

配置完成后，直接在对话里自然提问：

"帮我搜索近 3 年 graph neural network 在 drug discovery 领域的高引论文，挑两篇读一下摘要和方法"

AI 会自动组合调用 search_semantic、read_semantic_paper 等工具完成任务。