SourceMed MCP server
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
- Tools
- —
- 다운로드, 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.