学术搜索-MCP服务器

Name: 学术搜索-MCP服务器
Author: afrise

作者：afrise83 星标更新：2025-02-12

安装使用来源：spider==github.com

项目介绍

学术论文搜索 MCP 服务器

这是一个基于模型上下文协议 (MCP) 的服务器，用于从多个来源搜索和检索学术论文信息。

该服务器为大语言模型提供以下功能：

实时学术论文搜索功能
访问论文元数据和摘要
当有全文内容时，可以获取全文内容
遵循 MCP 规范的结构化数据响应

虽然主要设计用于与 Anthropic 的 Claude Desktop 客户端集成，但 MCP 规范允许与其他支持工具/函数调用能力的 AI 模型和客户端兼容（例如 OpenAI 的 API）。

注意：此软件正在积极开发中。功能可能会发生变化。

功能

此服务器提供了以下工具：

search_papers：在多个来源中搜索学术论文
- 参数：
  - query (str)：搜索查询文本
  - limit (int, 可选)：返回结果的最大数量（默认值：10）
- 返回：包含论文详情的格式化字符串
fetch_paper_details：检索特定论文的详细信息
- 参数：
  - paper_id (str)：论文标识符（DOI 或 Semantic Scholar ID）
  - source (str, 可选)：数据源（"crossref" 或 "semantic_scholar"，默认值："crossref"）
- 返回：包含全面论文元数据的格式化字符串，包括：
  - 标题、作者、年份、DOI
  - 场所、开放访问状态、PDF URL（仅限 Semantic Scholar）
  - 摘要和 TL;DR 概要（如有）
search_by_topic：按主题搜索论文，并可选地使用日期范围过滤器
- 参数：
  - topic (str)：搜索查询文本（限制为 300 字符）
  - year_start (int, 可选)：日期范围的起始年份
  - year_end (int, 可选)：日期范围的结束年份
  - limit (int, 可选)：返回结果的最大数量（默认值：10）
- 返回：包含搜索结果的格式化字符串，包括：
  - 论文标题、作者和年份
  - 摘要和 TL;DR 概要（如有）
  - 场所和开放访问信息

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Academic Paper Search Server 到 Claude Desktop：

npx -y @smithery/cli install @afrise/academic-search-mcp-server --client claude

注意：此方法尚未经过大量测试，因为他们的服务器似乎存在问题。您可以按照独立安装说明操作，直到 Smithery 修复为止。

通过 uv 手动安装：

安装依赖项：

uv add "mcp[cli]" httpx

在您的环境或 .env 文件中设置所需的 API 密钥：

# 这些尚未实际实现
SEMANTIC_SCHOLAR_API_KEY=your_key_here 
CROSSREF_API_KEY=your_key_here  # 可选但推荐

运行服务器：

uv run server.py

使用 Claude Desktop

将服务器添加到您的 Claude Desktop 配置 (claude_desktop_config.json) 中：

{
  "mcpServers": {
    "academic-search": {
      "command": "uv",
      "args": ["run ", "/path/to/server/server.py"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your_key_here",
        "CROSSREF_API_KEY": "your_key_here"
      }
    }
  }
}

重启 Claude Desktop

开发

此服务器使用以下构建：

Python MCP SDK
FastMCP 简化服务器实现
httpx 进行 API 请求

API 来源

Semantic Scholar API
Crossref API

许可证

本项目根据 GNU Affero 通用公共许可证 v3.0 (AGPL-3.0) 授权。此许可证确保：

您可以自由使用、修改和分发此软件
任何修改必须在相同的许可证下开源
提供网络服务的任何人必须公开源代码
允许商业用途，但软件及其衍生品必须保持免费和开源

请参阅 LICENSE 文件以获取完整的许可证文本。

贡献

欢迎贡献！以下是您如何帮助的方法：

分叉存储库
创建功能分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个拉取请求

请注意：

遵循现有的代码风格和约定
为任何新功能添加测试
根据需要更新文档
确保您的更改符合 AGPL-3.0 许可证条款

通过为此项目做出贡献，您同意您的贡献将根据 AGPL-3.0 许可证授权。