金大哥 - Academic Paper Search MCP 详情

article

README

🚀 学术论文搜索 MCP 服务器

本项目是一个基于 Model Context Protocol (MCP) 的服务器，支持从多个来源搜索和检索学术论文信息。它为大型语言模型（LLMs）提供实时学术论文搜索、论文元数据和摘要访问、获取可用全文内容等功能，并以符合 MCP 规范的结构化数据进行响应。虽然主要针对与 Anthropic 的 Claude 桌面客户端集成设计，但也能与其他支持工具/功能调用能力的 AI 模型和客户端兼容。

⚠️ 重要提示

此软件处于积极开发阶段，功能和特性可能会发生变化。

🚀 快速开始

安装

本服务器提供了两种安装方式，可根据需求选择：

使用 Smithery

通过以下命令安装并运行服务器：

smithery install @afrise/academic-search-mcp-server
smithery run

手动安装（使用 uv）

克隆仓库：

git clone https://github.com/yourusername/academic-paper-search.git

安装依赖项：

cd academic-paper-search
pip install -r requirements.txt

设置环境变量（如果需要身份验证）：

export API_KEY=your_api_key_here

启动服务器：

python server.py

使用

在 Claude 桌面客户端中配置服务器：

打开设置，导航到插件部分。
添加以下 JSON 配置：

{
    "server_url": "http://localhost:8000",
    "api_key": "your_api_key_here"
}

✨ 主要特性

该服务器暴露了以下实用工具：

`search_papers`

在多个来源中搜索学术论文。

参数：
- query (str)：搜索查询文本。
- limit (int, 可选)：结果的最大数量（默认值：10）。
返回：包含论文详细信息的格式化字符串。

`fetch_paper_details`

检索特定论文的详细信息。

参数：
- paper_id (str)：论文标识符（DOI 或 Semantic Scholar ID）。
- source (str, 可选)：数据源 ("crossref" 或 "semantic_scholar", 默认值： "crossref")。
返回：包含全面论文元数据的格式化字符串，包括标题、作者、年份、DOI、标题、摘要等。

`search_by_topic`

按主题搜索论文。

参数：
- topic (str)：搜索的主题或关键词。
- year_range (tuple, 可选)：年份范围（例如 (2015, 2023)）。
- language (str, 可选)：论文语言（例如 "English"、"Chinese" 等）。
返回：包含匹配论文标题和摘要的列表。

🔧 技术细节

项目使用技术

Python MCP SDK：提供 MCP 协议支持。
FastMCP：高性能的 MCP 服务器框架。
httpx：异步 HTTP 客户端和服务器。

API 来源

Semantic Scholar API：提供高质量的学术论文数据。
Crossref API：获取出版物元数据。

📄 许可证

该项目采用 AGPL - 3.0 协议，具体内容请参阅 LICENSE 文件。

🤝 贡献指南

欢迎大家参与项目贡献，以下是参与方式：

Fork 仓库：

git clone https://github.com/yourusername/academic-paper-search.git

创建功能分支：

git checkout -b feature/amazing-feature

提交更改：

git commit -m 'Add amazing feature'

推送到分支：

git push origin feature/amazing-feature

提交 Pull Request

注意事项

遵循现有的代码风格和约定。
为新功能添加测试。
更新相关文档。
确保更改符合 AGPL - 3.0 许可证条款。

通过参与此项目，您同意您的贡献将根据 AGPL - 3.0 许可证发布。

Academic Paper Search