scopus-mcp

Scopus MCP Server

中文 | English

💡 查看交互指南与提示词示例，了解如何与此工具对话！

这是一个 Model Context Protocol（MCP）服务，可访问 Elsevier Scopus API。它允许 AI 助手搜索学术论文、获取摘要并查找作者档案。

请注意，申请 Elsevier Scopus API 密钥通常要求所在组织或机构订阅 Elsevier 数据库服务。此外，如需无需手动设置即可运行此工具，设备必须安装 uv 包管理器。

配置

设置步骤

1. 前往 Elsevier Developer Portal 申请 API 密钥。
2. 在项目根目录创建 config.json 文件（或从 config.json.example 复制），并填入密钥：

   {
     "api_key": "YOUR_KEY_HERE"
   }
   

3. 编辑 MCP_tool_config.json，修改文件夹路径（注意斜杠方向）。
4. 最后，将 MCP_tool_config.json 的内容复制到 MCP 客户端（例如 Claude Desktop）中，导入配置。

🚀 快速开始（零设置）

前提条件：必须安装 uv。

• Windows：powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
• macOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh

如果使用 Claude Desktop，可以跳过下载代码，直接进行配置：

1. 获取密钥：从 Elsevier Developer Portal 获取免费 API 密钥。（⚠️ 注意：建议使用教育机构/机构邮箱；公共邮箱域名可能会被拒绝）。
2. 配置：编辑 %APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）。
3. 添加：

{
  "mcpServers": {
    "scopus-assistant": {
      "command": "uvx",
      "args": [
        "scopus-mcp"
      ],
      "env": {
        "SCOPUS_API_KEY": "PUT_YOUR_KEY_HERE"
      }
    }
  }
}

（如果没有 uv，请参阅安装了解手动设置方法）

与 Trae 配合使用

在 Trae 设置 -> MCP Servers -> 点击 Add -> 选择 Manual Configuration (JSON)，然后粘贴：

{
  "mcpServers": {
    "scopus-assistant": {
      "command": "uvx",
      "args": [
        "scopus-mcp"
      ],
      "env": {
        "SCOPUS_API_KEY": "PUT_YOUR_KEY_HERE"
      }
    }
  }
}

与 Cursor 配合使用

1. 打开 Cursor 设置 -> 功能 -> MCP Servers。
2. 点击 + Add New MCP Server。
3. 填写详细信息：
   • 名称：scopus-mcp
   • 类型：command（stdio）
   • 命令：uvx scopus-mcp
4. 重要：需要在系统环境变量中设置 SCOPUS_API_KEY。

安装

1. 确保已安装 Python 3.10+。
2. 安装依赖：

   pip install .
   

使用

运行服务

可以使用 uvx（推荐）或直接使用 python 运行服务。

# Using uvx
uvx --from . scopus-mcp

# Or directly
python -m scopus_mcp.server

可用工具

1. search_scopus

   • 使用标准查询语法搜索 Scopus 数据库。
   • 参数：
     • query（字符串）：搜索查询（例如 TITLE("Artificial Intelligence")）。
     • count（整数）：返回结果数（默认值：5）。
     • sort（字符串）：排序方式（例如 coverDate）。

2. get_abstract_details

   • 获取特定文档的详细信息。
   • 参数：
     • scopus_id（字符串）：文档的 Scopus ID。

3. get_author_profile

   • 获取作者的档案信息。
   • 参数：
     • author_id（字符串）：Scopus Author ID。

开发

运行测试：

pytest

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢与贡献者

• thinktraveller - 初始工作与核心开发
• qwe4559999 - 维护者