MCP PubMed Search
pubmed_search MCPサーバー
MCP経由でPubMedを検索
コンポーネント
リソース
サーバーは、次の機能を備えたシンプルなメモ保存システムを実装します。
個々のノートにアクセスするためのカスタム note:// URI スキーム
各ノートリソースには、名前、説明、text/plain mimetype があります。
プロンプト
サーバーは単一のプロンプトを提供します:
要約ノート: 保存されているすべてのノートの要約を作成します
詳細レベル(簡潔/詳細)を制御するためのオプションの「スタイル」引数
現在のすべてのメモをスタイルの好みに合わせて組み合わせたプロンプトを生成します
ツール
サーバーは 1 つのツールを実装します。
add-note: サーバーに新しいメモを追加します
必須の文字列引数として「name」と「content」を取ります
サーバーの状態を更新し、リソースの変更をクライアントに通知します
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 がインスペクタに表示されます。
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