mcp-scholarly MCP server

Overview

基本能力

产品定位

mcp-scholarly 是一个专注于学术文章搜索的 MCP 服务器，旨在为研究人员、学生和任何需要查找学术资料的用户提供便捷的搜索服务。

核心功能

提供 arXiv 学术文章的搜索功能
支持通过关键词搜索相关文章

适用场景

学术研究时快速查找相关论文
需要获取特定领域最新研究成果
文献综述时收集相关资料

工具列表

search-arxiv: 搜索与给定关键词相关的 arXiv 文章
能力: 接受"keyword"作为必需的字符串参数进行搜索

常见问题解答

调试建议: 由于 MCP 服务器通过 stdio 运行，调试可能具有挑战性。建议使用 MCP Inspector 进行调试。

使用教程

使用依赖

需要安装 Claude Desktop 或 Docker

安装教程

Claude Desktop 安装

MacOS 配置路径:

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows 配置路径:

%APPDATA%/Claude/claude_desktop_config.json

开发/未发布服务器配置:

"mcpServers": {
  "mcp-scholarly": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly",
      "run",
      "mcp-scholarly"
    ]
  }
}

已发布服务器配置:

"mcpServers": {
  "mcp-scholarly": {
    "command": "uvx",
    "args": [
      "mcp-scholarly"
    ]
  }
}

Docker 安装:

"mcpServers": {
  "mcp-scholarly": {
    "command": "docker",
    "args": [
      "run", "--rm", "-i",
      "mcp/scholarly"
    ]
  }
}

通过 Smithery 自动安装:

npx -y @smithery/cli install mcp-scholarly --client claude

调试方式

建议使用 MCP Inspector 进行调试:

npx @modelcontextprotocol/inspector uv --directory /Users/adityakarnam/PycharmProjects/mcp-scholarly/mcp-scholarly run mcp-scholarly

开发指南

构建和发布

同步依赖并更新 lockfile:

uv sync

构建包分发:

uv build

发布到 PyPI:

uv publish

需要设置 PyPI 凭证: - Token: --token 或 UV_PUBLISH_TOKEN - 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。