Claude Desktop 向け MCP、ChatGPT Actions（OpenAPI）、ChatGPT Connect（MCP）の 3 系統を順に紹介します。 どの方法でも NDB OpenData Hub の同じ読み取り専用データベースへアクセスできます。用途や利用環境に合わせて好みの導線を選んでください。
Option 1
Claude Desktop は MCP をネイティブ対応しています。本プロジェクトでは Node.js 版の mcp-bridge と、Node 不要のスタンドアロンバイナリの両方を提供しています。 どちらを使っても https://ndbopendata-hub.com/api/mcp に安全に接続できます。
GitHub Releases から OS に合わせてダウンロードしてください。
JSON と TOML のどちらでも利用可能です。パスのみご自身の環境に合わせてください。
JSON 例
{
"mcpServers": {
"ndb-mcp-bridge": {
"command": "/Users/you/Tools/ndb-mcp-bridge/ndb-mcp-bridge-macos-arm64",
"args": [],
"env": {
"NDB_MCP_SERVER_URL": "https://ndbopendata-hub.com/api/mcp",
"MCP_DEBUG": "false"
}
}
}
}TOML 例
[mcpServers.ndb-mcp-bridge]
command = "node"
args = ["/absolute/path/to/mcp-bridge/build/bridge.js"]
[mcpServers.ndb-mcp-bridge.env]
NDB_MCP_SERVER_URL = "https://ndbopendata-hub.com/api/mcp"
MCP_DEBUG = "false"さらに詳しい利用ガイドや FAQ は BRIDGE_STANDALONE_GUIDE.md を参照してください。
Option 2
ChatGPT 上で OpenAPI スキーマを用いた Actions として利用できます。最短手順は共有 GPT を使う方法、細かくカスタマイズする場合は OpenAPI URL を直接登録してください。
マニフェスト最小例
{
"schema_url": "https://ndbopendata-hub.com/mcp/openapi"
}確認: curl "https://ndbopendata-hub.com/api/mcp/inspection-range-labels?item_name=BMI" でレスポンスが取れるかテストできます。
OpenAPI の仕様詳細と最新スキーマは /mcp/openapi でいつでも参照できます。Actions 側でパラメータの扱いに迷った場合は、スキーマ内の説明と meta.hint をご確認ください。
Option 3
ChatGPT の Connect 機能（ベータ）を使って MCP サーバーとして直接接続する方法です。ブラウザ版 ChatGPT で利用でき、設定は数ステップで完了します。
2025年9月30日時点で ChatGPT Connect（MCP）は OpenAI 側でベータ提供中のため接続が不安定になることがあります。安定した運用が必要な場合は、同じ API を利用できる ChatGPT Actions（OpenAPI） を優先してください。
Connect の設定画面で表示される JSON を編集する場合の参考値です。
{
"name": "NDB OpenData Hub",
"description": "厚生労働省NDB特定健診データ（読み取り専用）",
"type": "mcp",
"server_url": "https://ndbopendata-hub.com/api/mcp"
}ブリッジ版を使いたい場合は server_url を http://localhost:<ポート>/api/mcp に変更してください。
Connect でも Actions と同じ MCP ツール群を利用します。利用時に API から戻るエラーがある場合は、パラメータの URL エンコードを確認し、必要に応じて複数指定（&value_range=...）を活用してください。
どのクライアントでも、まずは /api/mcp/inspection-range-labels や /api/mcp/questionnaire-answer-values で利用可能なラベルを取得し、続けて対象データを絞ると安定して結果が得られます。 特定の値が 0 件になる場合は、まず広めの条件で分布を確認してから該当ラベルを探すとエラーを回避できます。
Support
公開リポジトリとメール窓口の 2 経路を用意しています。小規模な実験運用のため即時対応や実装のお約束はできませんが、寄せられたご意見は優先度を検討しながら改善計画に反映します。GitHub アカウントをお持ちの場合は Issue 作成をご利用ください。スパム対策のため自動公開は行わず、内容を確認したうえで順次対応します。
GitHub を利用できない場合は、以下のアドレス宛にご連絡ください。
toms_pjt-ndbopendata@yahoo.co.jp
件名に [NDB Hub] を含めていただけると仕分けがスムーズです。頂いた内容は改善候補として整理し、対応状況に応じて個別にご連絡します。
オープンな議論が必要な場合は GitHub Discussions の開設も検討中です。短期的には Issue / メールでいただいた内容を整理し、対応可否を明示したうえで FAQ として本ページに反映していきます。