返回 MCP 目录
public公开dns本地运行

mcp-semantic-scholar-server

一个基于Semantic Scholar API的MCP服务器插件,用于学术文献检索

article

README

🚀 语义学者API MCP服务器

语义学者API MCP服务器借助mcp-python-sdk构建,为相关应用提供支持。

🚀 快速开始

📦 安装指南

要求执行以下命令安装依赖:

pip install -r requirements.txt

💻 使用示例

基础用法

运行以下命令初始化服务器:

mcp dev 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"
      ]
    }

⚠️ 重要提示

当前使用uvmcp可能会破坏某些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

建议的提示词系统提示

参见:benhaotang/my_agent_system_prompt,可以充分利用此MCP服务器的研究前缀人工智能代理。

🔧 技术细节

已知问题

  • 如果您看到类似INFO Processing request of type __init__.py:431 ListToolsRequest的日志信息,您可以忽略它们,因为这不会影响其正常运行,这是cline解析工具列表与控制台调试信息一起显示的结果。当前python - sdk无法禁用控制台消息。除了可以看到此警告外,它不会影响任何功能调用部分。

⚠️ 重要提示

如果您仍在使用FastMCP版本的此MCP服务器,请考虑再次拉取此仓库并更新到新版本,因为FastMCP已经弃用。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端