SourceMed MCPサーバー
コミット 2026年11月9日Allows an AI client to query a source-verified medical evidence library to retrieve clinical answers with primary source citations.
別名 tayeks/sourcemed-mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
SourceMed MCPとは
Allows an AI client to query a source-verified medical evidence library to retrieve clinical answers with primary source citations.
プロジェクトのREADMEから生成された概要
SourceMed MCP server について
Retrieving verified medical evidence with primary source citations is what developers can achieve using this MCP server. It connects AI clients to a library containing thousands of evidence cards and hundreds of clinical shelves, where every piece of information traces back to a published PMID or DOI. The server operates as a local stdio process and requires no accounts, API keys, or credentials to function, as it uses public endpoints.
Users can interact with the library through specific tools like ask_sourcemed to get answers to clinical questions, or list_shelves to see the full index. The search_shelves tool allows for keyword lookups across titles and headlines, while get_shelf provides deep access to a specific shelf's balance of evidence and MeSH terms. Because the server uses curl for HTTP requests, it maintains reliable connections even when navigating through egress proxies that might otherwise truncate data streams.
できること
- 1Query clinical evidenceAsk a specific medical question to receive verified evidence cards and shelf citations.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能tayeks/sourcemed-mcp is public and reachablegithub.com/tayeks/sourcemed-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-09github.com/tayeks/sourcemed-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るSourceMed MCP server
An MCP (Model Context Protocol) server for SourceMed — a source-verified medical evidence library built for agents. Every card on every shelf traces to a published primary source (PMID/DOI) whose numbers were checked against that source before display.
The library today (2026-11-08): 1,208 shelves, 3,845 evidence cards and
316 plain-language definitions — each shelf answers one clinical
question with the balance of the evidence and a developer's verdict.
Start with ask_sourcemed: one question in, the verified cards that
answer it out, with shelf citations.
The server uses only the site's public endpoints and files. No account, API key, or credentials are needed.
Tools
| Tool | What it does |
|---|---|
ask_sourcemed(question) |
Ask a clinical-evidence question. Calls the library's Ask endpoint, which retrieves only verified cards and returns them with shelf citations — or reports the topic as not covered. |
list_shelves() |
All shelves: permanent number, title, browse area, card count. |
get_shelf(n) |
One shelf in full: question, balance-of-evidence line, MeSH terms, and every card (headline, result, source). |
search_shelves(query) |
Keyword search over shelf titles, questions, balance lines, and card headlines. |
Install and run
Requires Python 3.10+ and curl on PATH (see "Implementation notes").
cd sourcemed/mcp-server
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt # the official mcp SDK, v1 line
.venv/bin/python server.py # stdio server; speaks MCP on stdin/stdout
Connect it to an MCP client
Generic stdio client configuration:
{
"mcpServers": {
"sourcemed": {
"command": "/path/to/sourcemed/mcp-server/.venv/bin/python",
"args": ["/path/to/sourcemed/mcp-server/server.py"]
}
}
}
If your environment reaches the internet through a proxy, make sure the
client passes http_proxy / https_proxy through to the server process
(some MCP hosts spawn servers with a minimal environment allowlist that
drops them; the server's HTTP calls will fail without them in proxied
environments).
The Ask endpoint (discovered interface)
Documented in the site's llms.txt and verified live on 2026-11-03:
- Request:
POST https://sourcemed.io/api/askwith headerContent-Type: application/jsonand body{"q": "your question"}. GET with a query parameter returns 404 — POST is the only format. The question must be a real question: a missing/too-shortqreturns HTTP 400 with{"covered": false, "error": "question too short"}. - Response (covered): HTTP 200,
{"covered": true, "summary": null, "shelves": [ ... ]}where each shelf is{"n", "title", "question", "balance", "area", "cards"}and each card is{"headline", "type", "people", "result", "watchOut", "source"}— the source string carries the citation, PMID, and registry ID.summarywasnullin all observed responses (the shelves/cards are the answer; the endpoint retrieves, it does not generate prose). - Response (not covered): HTTP 200,
{"covered": false, "summary": null, "shelves": []}.
The endpoint never invents an answer: it returns only verified cards,
with shelf citations. Carry the citation (SourceMed Shelf #NN, sourcemed.io) when you use a card's numbers.
Data sources
- Ask — the endpoint above.
- Shelf index (
list_shelves/get_shelf/search_shelves) — parsed from the homepage's public shelf sections (https://sourcemed.io/), cached in memory for one hour. Note:llms.txtdocuments the library, the deposit rules, and the Ask endpoint, and carries the site's definitions in full — but it does not itself contain a shelf list, so the shelf tools read the same public shelf sections the site serves to every visitor.
Implementation notes
HTTP is performed with curl rather than Python's HTTP stack: behind
some egress proxies, Python's stack receives truncated streams from the
site's worker (IncompleteRead at a fixed byte count), while curl
receives the full body reliably. The server needs no other system
dependencies.
Testing
.venv/bin/python test_client.py
Spawns the server over stdio, initializes a session, lists tools, and
calls each tool once. Latest run (2026-11-03): all checks PASS —
ask_sourcemed returned 3 shelves for a statin-after-heart-attack
question; list_shelves returned 245 shelves; get_shelf(106) returned
the aspirin primary-prevention shelf with its 3 cards;
search_shelves("aspirin primary prevention") found shelf #106.
Full output: test-output.txt / test-output.json.
Registry files
server.json— manifest in the official MCP registry schema (io.sourcemed/sourcemed). Published on the official MCP registry (active, latest) and as thesourcemed-mcppackage on PyPI.smithery.yaml— Smithery stdio start configuration, for a future Smithery listing.
Terms
Content is offered for reuse with attribution (CC BY): name SourceMed
and the shelf number. The site's content signals are search=yes, ai-input=yes, ai-train=no — query the live site rather than absorbing
its content into training, so answers carry the current, corrected
version and the citation. The verification standard, not the license,
is the quality guarantee.
SourceMed MCPのよくある質問
How does the ask_sourcemed tool work?
It takes a clinical-evidence question and retrieves verified cards with shelf citations, or reports if the topic is not covered.
Can the server generate medical prose?
No, the endpoint retrieves verified cards and does not generate prose; it returns the existing evidence and citations.