MCP PubMed Search
pubmed_search MCP 服务器
通过 MCP 搜索 pubmed
成分
资源
服务器实现了一个简单的笔记存储系统,其中包括:
用于访问单个笔记的自定义 note:// URI 方案
每个笔记资源都有一个名称、描述和文本/纯文本 mimetype
提示
服务器提供一个提示:
总结笔记:创建所有存储笔记的摘要
可选的“样式”参数用于控制详细程度(简要/详细)
生成提示,结合所有当前注释和样式偏好
工具
服务器实现了一个工具:
add-note:向服务器添加新注释
将“名称”和“内容”作为必需的字符串参数
更新服务器状态并通知客户端资源变化
Related MCP server: pubmed-search
配置
[TODO:添加特定于您的实现的配置详细信息]
快速入门
安装
克劳德桌面
在 MacOS 上: ~/Library/Application\ Support/Claude/claude_desktop_config.json在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json
发展
构建和发布
准备分发包:
同步依赖项并更新锁文件:
uv sync构建软件包分发版:
uv build这将在dist/目录中创建源和轮子分布。
发布到 PyPI:
uv publish注意:您需要通过环境变量或命令标志设置 PyPI 凭据:
令牌:
--token或UV_PUBLISH_TOKEN或用户名/密码:
--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD
调试
由于 MCP 服务器通过 stdio 运行,调试起来可能比较困难。为了获得最佳调试体验,我们强烈建议使用MCP Inspector 。
您可以使用以下命令通过npm启动 MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory /Users/nofuture/Documents/GitHub/pubmed_search run pubmed-search启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 以开始调试。
Available Tools
1 toolpubmed_searchC
Search PubMed medical literature database
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Medical/scientific search query | |
| max_results | No | Maximum number of results (1-15) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions searching but doesn't describe response format, pagination, rate limits, authentication needs, or error conditions. For a search tool with zero annotation coverage, this leaves significant behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero wasted words. It's appropriately sized and front-loaded, communicating the core purpose immediately without unnecessary elaboration.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a search tool with no annotations and no output schema, the description is insufficiently complete. It doesn't explain what the search returns, how results are structured, or any behavioral constraints. The 100% schema coverage helps with parameters but doesn't compensate for the lack of output and behavioral context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, thoroughly documenting both parameters (query and max_results). The description doesn't add any parameter-specific information beyond what's already in the schema, so it meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Search') and target resource ('PubMed medical literature database'), providing a specific verb+resource combination. However, since there are no sibling tools mentioned, it cannot demonstrate differentiation from alternatives, preventing a perfect score of 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or contextual constraints. It simply states what the tool does without offering usage instructions or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
pubmed_search
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool's purpose is clearly defined as searching the PubMed database, leaving no room for misselection.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The tool name 'pubmed_search' follows a clear verb_noun pattern that is appropriate for its function.
One tool is too few for a server named 'MCP PubMed Search', which suggests a broader scope for interacting with PubMed. A single search tool feels thin and incomplete, lacking operations like filtering results, retrieving article details, or managing queries.
The tool surface is severely incomplete for a PubMed search domain. While searching is a core function, there are obvious gaps such as no ability to get article metadata, filter searches, save results, or handle citations, which limits agent workflows significantly.
Maintenance
Related MCP Connectors
Auditable MCP server for PubMed, Europe PMC, ClinicalTrials.gov, and bioRxiv/medRxiv queries
PubMed MCP — wraps the NCBI E-utilities API (biomedical literature, free, no auth)
Search biomedical literature, get article details, find related articles, and explore MeSH terms
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that provides access to PubMed articles through the Entrez API.2113 PyPI172MIT
- AlicenseNot gradedqualityFmaintenanceMCP server for PubMed search and literature summarization52MIT
- AlicenseBqualityDmaintenanceThis MCP server provides 16 intelligent tools for searching, retrieving, and linking biomedical literature from PubMed and PMC. It enables LLM applications to perform complex queries, batch processing, and cross-database linking.168MIT
- AlicenseNot gradedqualityDmaintenanceThis server enables searching PubMed articles, fetching metadata, and downloading PMC PDFs.4MIT