Scholarly Search MCP 服务器使用说明

项目简介

mcp-scholarly 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端提供学术文章搜索功能。它实现了 MCP 协议，允许 LLM 通过标准化的方式调用工具来检索 Arxiv 和 Google Scholar 上的学术论文。

主要功能点

学术文章搜索: 提供 'search-arxiv' 和 'search-google-scholar' 两个工具，分别用于搜索 Arxiv 预印本库和 Google Scholar 学术论文。
关键词搜索: 工具接受关键词作为输入参数，返回相关的学术文章信息，包括标题、摘要、链接等。
MCP 协议支持: 完全兼容 MCP 协议，可以与任何支持 MCP 协议的 LLM 客户端（如 Claude）集成。
易于部署: 提供多种部署方式，包括本地运行、Docker 部署等。

安装步骤

环境准备: 确保已安装 Python 3.7 或更高版本，并安装了 'uv' 包管理器 (可以使用 'pip install uv' 安装)。

克隆仓库: 将 'mcp-scholarly' 仓库克隆到本地：

git clone https://github.com/adityak74/mcp-scholarly
cd mcp-scholarly

安装依赖: 使用 'uv' 安装项目依赖：
```
uv sync
```

服务器配置

要将 'mcp-scholarly' MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件。以下是针对 Claude Desktop 的配置示例，根据您的运行方式选择合适的配置添加到 Claude Desktop 的配置文件中。

注意: 以下配置中的路径 '/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly' 仅为示例，您需要替换为您本地 'mcp-scholarly' 仓库的实际路径。

开发/未发布服务器配置

适用于本地开发和调试，服务器直接从项目源代码运行。

"mcpServers": {
  "mcp-scholarly": {
    "command": "uv",  // 使用 uv 包管理器
    "args": [
      "--directory",  // 指定项目目录
      "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly", //  **[请替换为您的 mcp-scholarly 仓库路径]**
      "run",          // 运行命令
      "mcp-scholarly" // 运行 mcp-scholarly 服务器
    ]
  }
}

发布服务器配置

适用于已打包发布的服务器，假设 'mcp-scholarly' 包已安装到 Python 环境中。

"mcpServers": {
  "mcp-scholarly": {
    "command": "uvx", // 使用 uvx 运行已安装的��
    "args": [
      "mcp-scholarly" // 运行 mcp-scholarly 服务器
    ]
  }
}

Docker 服务器配置

适用于使用 Docker 镜像运行服务器。

"mcpServers": {
  "mcp-scholarly": {
    "command": "docker", // 使用 docker 命令
    "args": [
      "run", "--rm", "-i", // 运行 docker 容器，--rm 表示容器退出后自动删除，-i 表示保持标准输入打开
      "mcp/scholarly"      // Docker 镜像名称，假设为 mcp/scholarly
    ]
  }
}

Claude Desktop 配置文件位置:

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

打开 'claude_desktop_config.json' 文件，在 '"mcpServers"' 字段中添加上述配置代码块。如果 'claude_desktop_config.json' 文件中没有 '"mcpServers"' 字段，请手动添加。

基本使用方法

启动 MCP 客户端: 启动配置了 'mcp-scholarly' 服务器的 MCP 客户端，例如 Claude Desktop。

调用工具: 在 MCP 客户端中，您可以使用以下工具来搜索学术文章：

'search-arxiv': 搜索 Arxiv 预印本库。
'search-google-scholar': 搜索 Google Scholar 学术论文。

在客户端的对话框中，您可以指示 LLM 调用这些工具，并提供关键词作为参数。例如，在 Claude 中，您可以这样指示：

请使用 search-arxiv 工具搜索关于 "large language models" 的论文。

或者

请调用 search-google-scholar 工具，关键词是 "深度学习在自然语言处理中的应用"。

查看结果: 服务器会将搜索结果返回给客户端，客户端会根据结果进行展示或进一步处理。搜索结果通常包含文章的标题、摘要和链接等信息。

通过以上步骤，您就可以使用 'mcp-scholarly' MCP 服务器为 LLM 客户端提供学术文章搜索功能。

关键词