microquery-mcp

microquery-mcp

Microquery 用の MCP サーバーです。実世界のデータについて調査の質問をすると、実際のデータベースレコードを取得できます。Claude Desktop、Cursor、その他の MCP 対応 AI ホストで動作します。SQL は Claude が処理するため、質問するだけで利用できます。

ウォレットは不要です。最初のクエリ時に自動登録され、$0.10 のトライアルクレジット（一般的なクエリ約 1,600 回分）で利用を開始できます。

関連項目

microquery-agent — パイプラインや cron ジョブ向けの自律型エージェントです。登録 → USDC を入金 → クエリ → 自動チャージを行います。AI ホストなしで microquery を無人運用したい場合にご利用ください。

前提条件

• Python 3.9+
• サードパーティ製パッケージ不要 — 標準ライブラリのみ

インストール

Claude Desktop（推奨）

手間が少ない順に、簡単な方法をご紹介します。

1. レジストリからインストール Claude Desktop の MCP マーケットプレイス、または smithery.ai で microquery を検索し、インストールをクリックします。設定ファイルの編集は不要です。

2. uvx でインストール 次のファイルにエントリを 1 つ追加します。 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "microquery": {
      "command": "uvx",
      "args": ["microquery-mcp"]
    }
  }
}

uvx の使用には、別途 uv のインストールが必要です （astral.sh/uv）。インストールすると、Claude Desktop が自動的に認識します。

3. 手動でインストール (開発者向け) このリポジトリから microquery_mcp.py をダウンロードし、ホストからそのファイルを指定します。

{
  "mcpServers": {
    "microquery": {
      "command": "python3",
      "args": ["/path/to/microquery_mcp.py"]
    }
  }
}

編集後、Claude Desktop を再起動してください。接続されると、設定 → 開発者にサーバーが緑色の点とともに表示されます。

その他の MCP ホスト（Cursor など）

上記と同じ command / args のパターンを使用します。正確な設定形式については、お使いのホストの MCP ドキュメントを参照してください。

ツール

ツール	説明
query(database, sql)	microquery データセットに対して SQL を実行します。初回の呼び出し時に自動登録します。
authenticate(name, wallet_addr?)	ウォレットアドレスを手動で登録またはリンクします。
list_databases()	利用可能なすべてのデータセットとフィールドスキーマを表示します。
get_quickstart()	Sneller SQL のメモと、複数のデータセットを使ったレシピ例を表示します。

仕組み

1. 最初の query() 呼び出し時に、サーバーは OS のユーザー名（getpass.getuser()）を使って POST /v1/register でアカウントを登録し、API キーを ~/.microquery/token に保存します。
2. 以降の呼び出しでは保存されたキーを使用するため、設定は不要です。
3. 新しいアカウントには 100,000 µUSDC（$0.10）のトライアルクレジットが付与され、一般的なクエリを約 1,600 回実行できます。
4. トライアルクレジットが少なくなると、サーバーはアカウントに自動でチャージします（最大 10 回、各 $2）。無料利用枠を使い切るとチェックアウト URL が返されます。その URL にアクセスして USDC を追加すると、クエリを続行できます。

利用可能なデータセット

FDA 有害事象 · SEC EDGAR · 臨床試験 · ClinVar · arXiv · PubMed · Ethereum · Bitcoin · Base · DeFi TVL · FEC 献金 · FRED 経済統計 · NVD/CVE · OSV アドバイザリ · 制裁対象 · FHFA 住宅価格 · GWAS · ClinPGx · マルウェアサンプル · open food facts · 世界銀行の商品データ · その他 — 最新の全スキーマについては list_databases() を呼び出してください。

例

User:    What were the top adverse events reported for metformin last year?
         And how does that compare to 2022 and 2023?
Claude:  [queries fda.faers for each year, builds trend table]
         GI events (diarrhoea, nausea, vomiting) were flat 2022→2024,
         then spiked sharply in 2025 — consistent with the longevity/
         obesity wave hitting FAERS with a lag. Lactic acidosis stayed
         nearly flat across all four years despite overall volume growth.

User:    Can you cross-reference that with genomic profiles?
Claude:  [queries clinpgx, clinvar, gwas — no SQL needed from user]
         SLC22A1 rs628031 has a direct ClinPGx annotation for GI toxicity —
         the strongest known genomic explanation for why diarrhoea and nausea
         dominate the FAERS signal for metformin.