Semantic Scholar API MCP 服务器

基于 mcp-python-sdk 构建

[!IMPORTANT] 如果您仍然在使用此 mcp 服务器的 FastMCP 版本，请考虑重新拉取此仓库并更新到较新版本，因为 FastMCP 已经弃用。

用法

要求：pip install -r requirements.txt

运行 mcp dev path/to/semantic-scholar-plugin.py 以初始化服务器。

运行 mcp install path/to/semantic-scholar-plugin.py 以安装到 claude，或者将以下内容添加到 claude/cline 配置：

"semantic-scholar": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "/path/to/semantic-scholar-plugin.py"
      ]
    }

[!NOTE] 目前，将 uv 与 mcp 一起使用似乎会破坏某些 Linux/macOS 版本的 Claude-desktop，您可能需要将其设置为：

"semantic-scholar": {
      "command": "/path/to/mcp",
      "args": [
        "run",
        "/path/to/semantic-scholar-plugin.py"
      ]
    }

代替，/path/to/mcp 可以通过在终端运行 which mcp 获得

API 密钥

要使用具有更高速率限制的 Semantic Scholar API，您可以将您的 API 密钥设置为环境变量：

export SEMANTIC_SCHOLAR_API_KEY="your_api_key"

或者通过在 mcp 设置中添加 env 键来设置：

"semantic-scholar": {
      "command": ...,
      "args": ...,
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your_api_key"
      }
}

您可以通过填写以下表格获取 API 密钥：https://www.semanticscholar.org/product/api

建议的 Agent 系统提示

请参阅：benhaotang/my_agent_system_prompt，该 AI 预研 agent 可以充分利用此 mcp 服务器。

已知问题

• 如果您在 cline 中看到类似 INFO Processing request of type __init__.py:431 ListToolsRequest 的信息，您可以忽略它们，因为这不会影响其工作，这是因为 cline 将工具列表与控制台调试信息一起解析，并且当前的 python-sdk 无法禁用控制台消息。除了看到此警告之外，这不会影响任何函数调用部分。