YUZongmin_semantic-scholar-fastmcp-mcp-server

🚀 语义学者 MCP 服务器

语义学者 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  # 表示请求是否经过认证
        }
    }
}