pubmed_search MCP server

pubmed_search MCP server

site icon
2024.12.12 2
Python文献搜索笔记管理其它
pubmed_search 是一个基于 MCP 协议的 PubMed 文献搜索服务。它提供了一个简单的笔记存储系统,支持自定义的 note:// URI 方案来访问单个笔记。每个笔记资源包含名称、描述和文本/纯文本 MIME 类型。该服务还提供了一个提示功能,可以总结所有存储的笔记,并允许通过 'style' 参数控制摘要的详细程度(简要/详细)。此外,服务还实现了一个工具,用于添加新笔记到服务器。
View on GitHub

Overview

基本能力

产品定位

pubmed_search 是一个基于 MCP 协议的 PubMed 文献搜索服务,主要用于文献检索和笔记管理。

核心功能

  1. 实现了一个简单的笔记存储系统
  2. 支持自定义 note:// URI 方案访问单个笔记
  3. 每个笔记资源包含名称、描述和文本/纯文本 MIME 类型
  4. 提供提示功能
  5. summarize-notes: 创建所有存储笔记的摘要
    • 可选 "style" 参数控制详细程度(brief/detailed)
  6. 实现工具
  7. add-note: 添加新笔记到服务器
    • 需要 "name" 和 "content" 作为必需字符串参数
    • 更新服务器状态并通知客户端资源变更

适用场景

  1. 学术研究人员快速检索 PubMed 文献
  2. 文献阅读时进行笔记记录和管理
  3. 需要汇总多个文献笔记的场景

工具列表

  1. add-note: 添加新笔记到服务器
  2. 能力: 接受名称和内容作为输入,更新服务器状态并通知客户端

常见问题解答

  1. 调试困难: 由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性
  2. 推荐使用 MCP Inspector 进行调试

使用教程

使用依赖

  1. 需要安装 Claude Desktop
  2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

安装教程

  1. 开发/未发布服务器配置:
"mcpServers": {
  "pubmed_search": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/nofuture/Documents/GitHub/pubmed_search",
      "run",
      "pubmed_search"
    ]
  }
}
  1. 已发布服务器配置:
"mcpServers": {
  "pubmed_search": {
    "command": "uvx",
    "args": [
      "pubmed_search"
    ]
  }
}

调试方式

  1. 使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector uv --directory /Users/nofuture/Documents/GitHub/pubmed_search run pubmed-search
  1. 构建和发布:
uv sync
uv build
uv publish
  • 需要设置 PyPI 凭据:
    • Token: --tokenUV_PUBLISH_TOKEN
    • 或用户名/密码: --username/UV_PUBLISH_USERNAME--password/UV_PUBLISH_PASSWORD

许可证

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