语义学者 MCP 服务器

一个快速的 MCP 服务器实现，用于Semantic Scholar API，提供对学术论文数据、作者信息和引文网络的全面访问。

特性

• 论文搜索与发现

  • 具备全文搜索和高级筛选功能
  • 标题匹配论文查找
  • 论文推荐（单篇和多篇）
  • 批量获取论文详情
  • 高级搜索结合排序策略

• 引文分析

  • 引文网络探索
  • 参考文献追踪
  • 引文上下文与影响力分析

• 作者信息

  • 作者搜索和资料查询
  • 发表历史查看
  • 批量获取作者详情

• 高级功能

  • 多排序策略结合的复杂搜索
  • 可自定义字段选择
  • 高效批处理操作
  • 符合规范的限流策略
  • 支持认证和非认证访问
  • 平滑关闭与错误处理
  • 连接池与资源管理

系统要求

• Python 3.8+
• FastMCP 框架
• API密钥环境变量（可选）

安装

使用 FastMCP 安装：

fastmcp install semantic-scholar-server.py --name "Semantic Scholar" -e SEMANTIC_SCHOLAR_API_KEY=your-api-key

-e SEMANTIC_SCHOLAR_API_KEY 参数是可选的。未提供时，服务器将使用非认证访问，具有较低的速率限制。

配置

环境变量

• SEMANTIC_SCHOLAR_API_KEY: 您的 Semantic Scholar API 密钥（可选）
  • 在 Semantic Scholar API 获取您的密钥
  • 如果不提供，服务器将使用非认证访问

限流策略

服务器自动调整到适当的速率限制：

带有 API 密钥：

• 搜索、批量和推荐端点：每秒1次请求
• 其他端点：每秒10次请求

无密钥时：

• 所有端点：5分钟内100次请求
• 请求超时时间更长

可用的 MCP 工具

注意：所有工具均与官方 Semantic Scholar API 文档 对齐。请参考官方文档获取详细的字段说明及更多信息。

错误处理

服务器提供标准错误响应：

{
    "error": {
        "type": "error_type",  # 可能的错误类型：限流、API错误、验证失败、超时等
        "message": "错误描述",
        "details": {
            # 额外上下文
            "authenticated": true/false  # 表示请求是否经过认证
        }
    }
}