Histopathology Atlas for ChatGPT & Claude

Search the Patoloji Atlası / Histopathology Atlas from inside your AI assistant and zoom into real whole-slide images without leaving the chat.

"Show me a gastric signet ring cell carcinoma slide" · "Lenfositik gastritte CD3 boyasını göster" · "Give me a quiz case"

• About 229 whole-slide images in 160 cases: H&E, histochemistry (PAS, Giemsa, Congo red…), immunohistochemistry (CD3, GFAP, Ki-67…) and cytology.

• Ask in English or Turkish. Each answer links to the case's section on both atlas sites.

• Quiz mode: Hacettepe Case of the Month slides keep their diagnosis hidden.

• Read-only, no sign-in, no cookies, no tracking.

Educational use only. Not for diagnosing individual patients, and please never type patient identifiers. See the Terms of Use and Privacy Policy.

Connect

Server URL:

https://atlas-mcp.serdarbalci.workers.dev/mcp

No authentication is needed.

Türkçe

Sunucu adresi: https://atlas-mcp.serdarbalci.workers.dev/mcp (giriş gerekmez).

• Claude: Customize → Connectors → + → Add custom connector → adresi yapıştırın. Sohbette bağlayıcıyı + menüsünden açın.

• ChatGPT (web): Ayarlar → Security and login → Developer mode'u açın, ardından chatgpt.com/plugins → + → adresi yapıştırın, No authentication seçin.

• Örnek sorular: "Amiloid örneklerini göster", "Helicobacter pylori Giemsa kesitini aç", "Bana bir quiz olgusu ver".

Yalnızca eğitim amaçlıdır; hasta tanısı için kullanmayın ve hasta kimlik bilgisi yazmayın.

Related MCP server: ICD MCP Server

What you get

Both tools are read-only. The viewer is built on the open MCP Apps standard, so one server works in ChatGPT and Claude.

Support

• Bugs, wrong slide titles, missing cases: open an issue.

• About the atlas content: patolojiatlasi.github.io issues.

• Email: serdarbalci@serdarbalci.com

Licence

• Code: MIT.

• Atlas images and case text (including data/catalog.json): CC BY 4.0. Credit Patoloji Atlası / Histopathology Atlas (patolojiatlasi.com).

Development

ChatGPT / Claude ──MCP──► Cloudflare Worker /mcp ── data/catalog.json (bundled)
viewer iframe ── OpenSeadragon + MCP Apps bridge (same Worker, /vendor) ── tiles (images.patolojiatlasi.com)

npm install
npm run catalog        # rebuild data/catalog.json (ATLAS_DIR defaults to ../patolojiatlasi.github.io)
npm test
npm run dev            # http://localhost:8787/mcp (viewer scripts from localhost); inspect with: npx @modelcontextprotocol/inspector
npx wrangler login     # once
npm run deploy
npx wrangler tail      # live request log: request type and tool name only

After new atlas cases: pull the atlas repo once its CI has finished, then run npm run catalog && npm test && npm run deploy and commit data/catalog.json.

• npm run catalog drops a slide only on a real 404 and fails on network errors.

• It refuses to write if the slide count falls more than 5% (-- --force overrides).

Gotchas

• Host caching: ChatGPT and Claude cache tool and resource metadata. After changing viewer.html, bump viewer-vN in src/worker.js and refresh the connector.

• CSP: every domain the viewer loads from must be listed in resourceDomains and openai/widgetCSP (src/worker.js), or hosts block it. Directory reviewers check that the list matches what the viewer actually loads.

• Upgrading OpenSeadragon or ext-apps: npm install the new version, run npm run vendor, paste the printed SRI hashes and file names into viewer.html, and bump viewer-vN. npm test fails if a hash doesn't match.

• ui.domain: don't set it. Claude only accepts its own hash value there. ChatGPT reads openai/widgetDomain instead.

• OpenAI domain verification: npx wrangler secret put OPENAI_APPS_CHALLENGE serves the token at /.well-known/openai-apps-challenge.

• Tile host: images.patolojiatlasi.com (GitHub Pages) rejects CORS preflights, so the viewer must keep making plain GETs.

• Quiz cases: diagnoses sit in the search-only terms field. show_slide and search results never return that field.

Directory listing: SUBMISSION.md. Build notes and lessons learned: TODO.md, CHANGELOG.md.