Semantic Scholar API MCP server

基本能力

产品定位

mcp-semantic-scholar-server 是一个学术研究工具，旨在通过 Semantic Scholar API 提供学术文献的检索和分析功能。

核心功能

1. Semantic Scholar API 集成：支持通过 API 查询学术文献，包括论文、作者、引用等信息。
2. MCP 协议支持：通过 MCP 协议与 Claude 或其他客户端集成，提供工具调用功能。
3. API 密钥管理：支持通过环境变量或配置文件设置 Semantic Scholar API 密钥，以提高查询速率限制。
4. 调试信息：提供调试信息，帮助开发者排查问题。

适用场景

1. 学术研究：用于快速检索和分析学术文献，支持研究人员的日常工作。
2. AI 代理：与 AI 代理系统集成，提供学术数据支持，例如预研究代理。
3. 开发工具：作为开发工具的一部分，提供学术文献查询功能。

工具列表

1. Semantic Scholar API：提供学术文献的检索和分析功能。
2. MCP Python SDK：用于构建和运行 MCP 服务器。

常见问题解答

1. 调试信息干扰：如果看到 INFO Processing request of type __init__.py:431 ListToolsRequest 等调试信息，可以忽略，这些信息不会影响功能。
2. API 密钥设置：可以通过环境变量或配置文件设置 API 密钥，以提高查询速率限制。
3. Linux/macOS 兼容性问题：在某些 Linux/macOS 版本的 Claude-desktop 中，使用 uv 与 mcp 可能会出现问题，建议直接使用 mcp 路径运行。

使用教程

使用依赖

安装依赖：

pip install -r requirements.txt

安装教程

1. 初始化服务器：

mcp dev path/to/semantic-scholar-plugin.py

1. 安装到 Claude 或添加到配置文件：

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

或直接使用 mcp 路径：

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

调试方式

1. 设置 API 密钥：

export SEMANTIC_SCHOLAR_API_KEY="your_api_key"

或通过配置文件设置：

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

1. 获取 API 密钥： 访问 Semantic Scholar API 填写表单获取。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。