molecare-mcp

MoleCare MCP Server

Claude やその他の MCP クライアントから、以下にアクセスできる Model Context Protocol（MCP）サーバー です。

1. 皮膚科の知識 — ABCDE の解説、SNOMED CT / ICD-10 ヘルパー、リスク要因に関するプロンプト
2. オプションの MoleCare API ツール — ほくろ、経時的な変化、分析（独自のバックエンド + API キーが必要）
3. オプションの MLOps / 運用ツール — 別の バイナリ molecare-ops-mcp として提供（モック優先）

医療機器ではありません。 出力は教育および業務上の補助のみを目的としています。診断や治療の判断には使用しないでください。

製品サイト：molecare.co.uk · アプリ：iOS · Android

コマンドは 1 つだけ。API キーもデータベースも不要です。公開パッケージからの実際の出力です。

このプロジェクトの目的

MoleCare は、ほくろを長期的に記録し、医療従事者の診察に備えるためのものです。この MCP サーバーを使うと、開発者や運用担当者は次のことができます。

• Claude Desktop / Cursor から、皮膚の健康に関する教育的な知識を照会する
• MoleCare 互換 API を使って、アシスタントのワークフローを試作する
• 認証情報が設定されていない場合に、安全なモックデータで MLOps ツールを試す

クイックスタート

認証情報、データベース、クラウドアカウントは不要です。以下を MCP クライアントの設定に追加し、 再起動してください。

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"]
    }
  }
}

macOS の Claude Desktop では、設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json です。

皮膚科の知識ツールはすぐに使えます。パッケージに同梱されたナレッジベースを読み込むためです。バックエンドと通信する機能は、設定を行うまで、明確にラベル付けされたモックデータを返します。そのため、利用するかどうかを決める前に、すべてのツールを試すことができます。

クライアントを使わずに試すには、次を実行します。

npx -y molecare-mcp

起動すると、stdio で待機します。出力がなければ、正常に動作しています。

Claude Code プラグイン

このリポジトリは Claude Code プラグインでもあります。同じサーバーに加えて、Claude にいつ使うかを伝え、決して診断しないよう指示するスキルが含まれています。

claude plugin marketplace add MoleCare/molecare-mcp
claude plugin install molecare@molecare

続いて、「ABCDE の E は何を意味しますか？」や「皮膚科の診察に備えるのを手伝ってください」のように尋ねてください。プラグインはキーなしで npx -y molecare-mcp を実行するため、アカウントのツールは "dataSource": "mock" とラベル付けされたサンプルデータを返します。

実際のバックエンドへの接続

MoleCare 互換 API を実行している場合にのみ必要です。

{
  "mcpServers": {
    "molecare": {
      "command": "npx",
      "args": ["-y", "molecare-mcp"],
      "env": {
        "MOLECARE_API_URL": "http://localhost:8080/api",
        "MOLECARE_API_KEY": "your-local-api-key"
      }
    }
  }
}

localhost（または独自のデプロイ環境）を使用してください。クラウドドライブに同期される設定ファイルには、本番用のキーを貼り付けないでください。

環境変数

すべての設定は任意です。パブリックサーバーは API 認証情報がない場合、製品データのモックにフォールバックします。また、知識ツールはオフラインでも引き続き動作します。運用サーバーでは、統合機能をモックモードに保つため、NODE_ENV=development（.env.example のデフォルト）を使用してください。

両方のバイナリで共通

パブリックサーバー（molecare-mcp）

パブリックサーバーに追加設定はありません。皮膚科のナレッジは設定なしで利用でき、共通の MoleCare API 変数を設定すると、オプションのほくろおよびプロフィール用ツールが有効になります。

オペレーションサーバー（molecare-ops-mcp）

オペレーション用バイナリも、上記の共通設定を受け付けます。以下の追加変数は、インフラストラクチャ、モニタリング、CI/CD 用ツールのみを設定します。

コピーして使用できる正本の一覧は、.env.example を参照してください。

ツール

皮膚科の知識 — セットアップ不要

多くの人がこのツールをインストールする理由となる機能です。組み込みのナレッジベースから回答するため、API、キー、ネットワークは必要ありません。

リソース： molecare://knowledge/* — ABCDE 基準、フィッツパトリックの皮膚タイプ、予防、皮膚科医を受診すべきタイミング。molecare://ontology/* — SNOMED CT と ICD-10 の参照リスト、完全な snomed-icd10-map 対応表、および出典メタデータ付きのリスク因子。

教育用プロンプト

サーバーは、再利用可能な 3 つの MCP プロンプト walk_through_abcde、prepare_dermatology_appointment、explain_snomed_code も公開します。これらは、疾患の診断、緊急度の判定、リスクスコアの算出を行わずに、クライアントが観察内容を整理したり、用語を説明したりするのに役立ちます。レンダリングされるすべてのプロンプトには、診断を目的としない教育用の免責事項が含まれます。用語に関するプロンプトには、SNOMED CT コードの引数が必要です。

用語が実際にカバーする範囲

サーバーが案内するすべての SNOMED 概念は、lookup_medical_concept で解決でき、map_snomed_to_icd10 で対応付けられます。この範囲外のコードを指定すると、空の結果ではなく、組み込み済みの内容を示す coverage ブロックが応答に含まれます。molecare://ontology/snomed-icd10-map リソースで表全体を参照できます。

ICD-10 の対応範囲は、意図的に SNOMED の対応範囲より広くなっています。組み込みの SNOMED 概念セットの拡張は、SNOMED International との再配布に関する問題が解決するまで保留中です。加盟国での無料の使用は、非加盟地域への npm 経由での無料の再配布と同じではありません （#49）。WHO はこの範囲の ICD-10 をより寛容な条件でライセンスしているため、その側は当面拡張できます。

用語の出典

同梱されている SNOMED CT／ICD-10 ヘルパーは、ライセンスされた用語配布物ではなく、教育用サブセットです。出典名は src/resources/terminology-provenance.ts に記載されており、map_snomed_to_icd10 とオントロジーリソースで返されます。

データセット本体は src/resources/terminology-data.ts にあり、src/api/ontology-client.ts のモック経路とオントロジーリソースの両方で使用される唯一の情報源です。臨床コードを含まない教育用の説明文は src/resources/medical-kb.ts にあります。

MoleCare の製品データ — API が必要です

MOLECARE_API_URL が設定されるまで、ラベル付きのモックデータを返します。

{
  "mcpServers": {
    "molecare-ops": {
      "command": "npx",
      "args": ["-y", "-p", "molecare-mcp", "molecare-ops-mcp"]
    }
  }
}

npm i @aws-sdk/client-ec2 @aws-sdk/client-cloudwatch

アーキテクチャ

Claude / Cursor / MCP client
        │ stdio (JSON-RPC)
        ▼
  molecare-mcp                    molecare-ops-mcp
   ├─ medical KB (local)           ├─ MLflow / Feast clients
   ├─ MoleCare API client          ├─ AWS / CI / K8s clients
   └─ ontology client              └─ database / app clients
        │    (14 tools)                 │   (39 tools, internal)
        │                               │
        └───────────┬───────────────────┘
                    └─ optional HTTP GET /health  (Docker / ECS)

Docker

docker build -t molecare-mcp .
docker run --rm -p 3000:3000 molecare-mcp
curl http://localhost:3000/health

セキュリティ

• .env ファイルや API キーは絶対にコミットしないでください。脆弱性の報告については SECURITY.md をご覧ください
• デモやスクリーンショットには、モックモードを優先してください
• userId を受け付けるツールが PHI を返すのは、実際の認証を備えた実際のバックエンドを指定した場合に限られます。その場合は本番環境として扱ってください
• レート制限と認証は、MCP プロセスだけでなく API に設定してください

医療に関する免責事項

MoleCare MCP は、教育目的の情報と開発者向けツールを提供します。メラノーマやその他の疾患を診断するものではありません。医療に関する懸念がある場合は、必ず資格を持つ臨床医にご相談ください。

開発

git clone https://github.com/MoleCare/molecare-mcp.git
cd molecare-mcp
npm install
npm run build
npm run dev      # auto-reload
npm run inspect  # browse tools in MCP Inspector

貢献を歓迎します。まず CONTRIBUTING.md をお読みください。モック優先のルール、医療コンテンツに関する臨床安全性の境界、good first issue の選び方について説明しています。

例にシークレットを含めないようにし、localhost をデフォルトとして使用してください。

関連リンク

環境変数： .env.example が正式な一覧です。CI では、このファイルと両方のサーバーエントリーポイントから参照可能な変数を比較し、上記の公開用／運用用のグループ分けを確認します。

• Model Context Protocol
• MoleCare
• MoleCare-ML — メラノーマ分類サービスとトレーニング用ノートブック

掲載先

• npm（molecare-mcp として掲載）
• MCP サーバーをインデックス化する Glama と MCP Servers Live
• MCP サーバーとエージェントスキルのマーケットプレイスである mcprush：無料で、npm パッケージからインストールでき、mcprush がホストするものはありません

どこかで利用した場合や、紹介記事を書いた場合は、Issue を作成してください。ここに掲載します。

コントリビューター

molecare-mcp に協力してくださった皆さんに感謝します。

一覧は、GitHub のコミットから Contributors によって生成され、ボットは除外されます。古い一覧はないほうがましなので、手動では更新しません。コントリビューターグラフ · good first issue

ライセンス

Apache-2.0 © Yauhen Bichel