ClinicMarketIQ Public Data

io.github.evgeniy-yudin由 GitHub 帳號 evgeniy-yudin 發布v0.1.0更新於 Oct 27, 2026

Read-only U.S. healthcare dataset metadata, schemas, immutable downloads, and checksums.

已驗證Streamable HTTP可網頁執行檔案與儲存資料與分析

概覽

AI 產生的概覽

唯讀的遠端 MCP 伺服器，用來探索 ClinicMarketIQ 公開的美國醫療資料集：目錄搜尋、中繼資料、結構描述、下載連結與校驗碼比對。

可以做什麼
  • 依 ID、slug、名稱或發布者列出並搜尋公開資料集系列
  • 取得資料集的標準機器索引，含來源資訊與不可變清單指標
  • 從資料集的不可變清單讀取宣告的 JSON 結構描述
  • 回傳直接下載連結、大小、格式與宣告的 SHA-256 值
  • 將呼叫端提供的 SHA-256 摘要與宣告值比對
適用情境
當助理需要尋找、檢視或驗證 ClinicMarketIQ 公開的美國醫療資料集發行版本（例如確認結構描述或核對檔案校驗碼）時適用。
執行需求
需要遠端 Streamable HTTP 端點；未宣告驗證、API 金鑰或環境變數。伺服器本身不需本機執行環境；README 的 Node.js 要求僅適用於在本機執行該 Worker。
安裝前請注意
所有工具皆為唯讀，伺服器不代理資料集位元組，檔案須直接從 ClinicMarketIQ 下載。端點未經驗證且無狀態，限流依賴 Cloudflare 規則。中繼資料僅供探索，不構成臨床建議，也不代表可重複使用第三方資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ClinicMarketIQ Public Data，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.evgeniy-yudin%2Fclinicmarketiq-public-data/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "clinicmarketiq-public-data": {
      "type": "http",
      "url": "https://clinicmarketiq-public-mcp.rotgar-fizkl.workers.dev/mcp"
    }
  }
}

README

ClinicMarketIQ public MCP Worker

Minimal stateless, read-only remote MCP server for discovery of ClinicMarketIQ public datasets. It exposes Streamable HTTP at /mcp and a process-only health response at /healthz.

This directory is intentionally self-contained. The reviewed build is deployed at https://clinicmarketiq-public-mcp.rotgar-fizkl.workers.dev/mcp; the canonical setup page is https://clinicmarketiq.com/mcp/. External MCP Registry publication is tracked by server.json.

Tools

ToolPurpose
list_datasetsPage through compact public catalog summaries.
search_datasetsSearch dataset ID, slug, name, and publisher.
get_dataset_metadataFetch a dataset's canonical public machine index.
get_schemaFollow the immutable manifest and return its declared JSON schema(s).
get_download_urlReturn direct immutable artifact URLs, sizes, formats, and SHA-256 values; never proxy file bytes.
verify_checksumCompare a caller-provided SHA-256 value with the digest declared in canonical metadata. It does not re-download and hash large artifacts.

The Worker proxies small canonical JSON documents from https://clinicmarketiq.com rather than copying release metadata into the server bundle. Every derived URL is restricted to that exact origin and an allowlisted public path. Dataset bytes are never fetched by the MCP server.

Local verification

Requires Node.js 22.18+ or 24.11+ (odd-numbered Node releases are not supported by the pinned Vitest toolchain).

sh
npm installnpm run typesnpm run checknpm testnpm run dry-run

Start locally with npm run dev, then connect an MCP client or the MCP Inspector to http://localhost:8787/mcp. npm run dry-run bundles and validates the Worker but does not deploy it.

Security and operational boundaries

  • All six tools are annotated read-only, non-destructive, and idempotent.
  • The server uses Cloudflare's stateless createMcpHandler; there is no Durable Object, KV, D1, session store, or write-capable binding.
  • Upstream fetches use a fixed origin, reject redirects, require JSON, have an 8-second timeout, and stream into bounded buffers. Catalog, index, manifest, and schema documents have separate size ceilings.
  • Catalog routes, release IDs, dataset IDs, slugs, manifest URLs, schema names, download URLs, encodings, and SHA-256 values are validated before being returned or followed.
  • MCP request bodies are streamed into a bounded 64 KiB buffer and rejected above that limit, including chunked requests without Content-Length. A matching Cloudflare WAF body-size rule should reject abuse before Worker CPU is consumed.
  • Browser Origin and endpoint Host validation are provided by the MCP handler. Before adding a custom domain, configure exact allowedHostnames, allowedOriginHostnames, and CORS origins; do not use wildcard origin bypasses for the public unauthenticated route.
  • No authentication is required because every exposed action reads already-public metadata. If tools later expose non-public data or costly computation, add OAuth/Cloudflare Access and per-tool authorization before release.
  • No request bodies, dataset queries, artifact URLs, or auth tokens are logged. Structured error logs contain only method, path, and a bounded error message.

Rate limiting

This Worker is stateless, so it does not pretend to enforce a reliable per-client counter in isolate memory. Before external registration, attach a Cloudflare rate-limiting rule to the exact /mcp route (for example, by verified client identity when OAuth exists, otherwise IP plus a conservative burst/window), and add a WAF rule for malformed or oversized requests. Monitor 429 rate, upstream error rate, CPU time, and subrequest volume before increasing limits.

The public metadata origin should also retain its own cache and abuse controls. Do not turn get_download_url into a byte proxy: clients should download immutable artifacts directly from ClinicMarketIQ so CDN controls and checksums remain authoritative.

Deployment and registration gate

Before changing, redeploying, or registering a new version of this server externally:

  1. Re-run npm run types, npm run check, npm test, and npm run dry-run from a clean checkout.
  2. Confirm the current https://clinicmarketiq.com/catalog.json and at least one dataset machine index, immutable manifest, schema, and download URL return the expected content types and release ID.
  3. Choose the final Worker/custom-domain hostname and configure exact MCP Host/Origin policy.
  4. Add route-level WAF and rate-limiting rules, then test 413/429 behavior.
  5. Perform an independent YMYL/privacy/rights review. This server is discovery infrastructure and must not imply that metadata is clinical advice, all-payer coverage, or permission to reuse third-party data.
  6. Deploy to a non-production environment, validate with the MCP Inspector, and only then decide whether to register the endpoint with external clients.

References

來源：mcp/README.md，提交 4180e84

工具

6

list_datasets

List ClinicMarketIQ datasets

List public ClinicMarketIQ dataset families from the canonical catalog. Returns metadata summaries, not observation rows.

輸入參數limitoffset

search_datasets

Search ClinicMarketIQ datasets

Search public dataset family IDs, names, slugs, and publishers in the canonical ClinicMarketIQ catalog.

輸入參數limitquery必填

get_dataset_metadata

Get dataset metadata

Fetch the canonical public machine index for one ClinicMarketIQ dataset family, including provenance-facing download metadata and immutable manifest pointer.

輸入參數dataset必填

get_schema

Get dataset schema

Fetch schema JSON declared by a dataset's immutable public manifest. If schema_name is omitted, returns all declared schemas (currently capped at 10).

輸入參數dataset必填schema_name

get_download_url

Get immutable download URL

Return canonical direct download URLs and declared SHA-256 values for a public dataset. This tool never proxies the dataset bytes.

輸入參數groupformatdataset必填

verify_checksum

Verify a declared checksum

Compare a caller-provided SHA-256 digest with the canonical digest declared in the public dataset machine index. This bounded check does not download or re-hash large artifact bytes.

輸入參數sha256必填dataset必填filename必填

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。