nyambot-mcp

nyambot-mcp

フランスの公共データを、AI エージェントが 活用できる ようにするインテリジェンスレイヤーです。

フランスの公共データは公開されていますが、生データのまま数十もの API に分散しており、コンテキストの中では読み解きにくいものです。本当の課題はデータに アクセスする ことではなく、理解することです。つまり、この状況において、どのデータセット、どの列を使い、どう解釈するかということです。そこで Nyambot の出番です。エージェントに代わってこの作業を行うインテリジェンスシステムとして、データを照会し、突き合わせ、コンテキストを加え、CSV の行を解析させるのではなく、出典付きでそのまま活用できる回答を返します。

あなたの AI（Claude、ChatGPT、Le Chat など）はフランスのことを知りません。単独では、日付も出典も示さずに、読んだ内容を言い換えるだけです。Nyambot に接続すれば、質問をしたその瞬間に政府のデータを照会し、出典を明記します。

▶ Nyambot の完全版エージェントがオンラインで利用できます。お試しください：nyambot.ai

例：エージェントは resolve_commune → risques_immobilier → dpe_logement と続けて呼び出し、数秒で物件について根拠のある判定を提示します。生の API では、解釈が必要な表しか返ってきません。

• 🧠 行ではなく、回答を。 1 回の呼び出しで、業務に活用できる回答を 1 つ返します。どのデータセットや列を照会すべきか知る必要はありません。
• 📎 出典付きで、ハルシネーションなし。 各回答には公式の出典（日付、参照、金額）が付いています。
• 🆓 無料、API キー不要のオープンソースコアです。uvx を使って 1 行でインストールできます。
• 📖 オープンソース、MIT ライセンス。

このパッケージは、キー不要のオープンソースコア（ローカルで 4 つのツール）です。 完全版 — 21 のツール（実際の DVF 不動産市場、Légifrance、SIRENE、Service-Public の案内、各種支援など）、回答としてすぐ使える形式で出典付きの情報を提供するホスト型コネクターは、オンラインで利用できます → https://mcp.nyambot.ai/mcp（OAuth 2.1）。バックエンド／サーバー間連携（マシンキー）は要問い合わせです。詳細は以下をご覧ください。

---

Nyambot を選ぶ理由 — ゲームチェンジャー

フランスでは、行政手続きが迷路のようになっているため、受給資格がないからではなく、毎年数十億ユーロ相当の権利が申請されずにいます。問題は、データへのアクセスではありません（データは公開されています）。状況に応じて正しく理解し、間違えずに扱うことです。これこそ Nyambot のインテリジェンスレイヤーが担う仕事であり、生の API にアクセスするだけでは決して得られません。

Nyambot.ai は、単に情報を提供するだけではない AI エージェントです。政府の公式データに基づいて手続きを実行し、すべての回答に出典を付け、ハルシネーションを起こしません。一般的なチャットボットが情報を作り上げ、公的なポータルが手続きを支援しない一方で、Nyambot は行動します。

身分証明書、税金、運転免許証、車両登録証、各種支援・手当、引っ越し、相続、起業、不動産など、あらゆるライフイベントに対応します。nyambot-mcp を使えば、その機能の一部をあなた自身の AI エージェントに利用させることができます。

リアルタイムで進む不動産分析

完全版のエージェント（nyambot.ai）では、*「Pierrelatteのこの家は286,000 €で適正価格ですか？」*のような質問をすると、手順を追って見える形で分析が行われます。エージェントがDVFファイルを取得して展開し、リスクやDPEと照合します。

📊 DVF — Demandes de valeurs foncières (data.gouv.fr)
   Requête : commune = Pierrelatte (26235) · type = Maison · 2023–2024
   → 38 ventes comparables · médiane du secteur ≈ 2 053 €/m²

⚠️ Géorisques : aléa retrait-gonflement des argiles (moyen)
🏷️ DPE du bien : étiquette A

判定：～2,750 €/m²の場合、この物件は地域の中央値（DVFの情報、比較対象となる38件の売買）を約34％上回っています。DPE Aで正当化できますが、値下げ交渉の余地があります。注意点：建物が粘土質地盤の危険区域にあるか確認してください。

公式データを取得し、展開して照合し、情報源を明記します。わずか数秒です。一般的なチャットボットにはできません。

v2を公開しました。 ホスト型コネクターmcp.nyambot.ai/mcpを使えば、フランスの最新の公開データ（行政手続き、実際のm²あたり不動産価格（DVF）、法令（Légifrance）、企業データ（SIRENE））をすべて利用できます。データはすでにインデックス化され、引用可能で、すぐに使えます。

DVF、Service-Publicの情報シートのRAG、セマンティックソースへのプログラムによるアクセスは、ホスト型コネクターで今すぐ利用可能です（詳細は後述）。以下の無料コネクターでは、自治体、ジオコーディング、リスク、DPEをローカルで、キー不要で利用できます。

---

利用可能なツール

ツール	機能	公式ソース
resolve_commune	自治体名 → INSEEコード、県、地域、座標、人口	geo.api.gouv.fr
geocode_address	住所 → 座標、郵便番号、自治体、INSEEコード	Base Adresse Nationale
risques_immobilier	自治体の自然災害・技術的リスク（洪水、粘土質地盤、地震、ラドンなど）	Géorisques
dpe_logement	既存住宅のDPE（評価A→G、GES、面積、消費量）	ADEME

---

公式のdata.gouv MCPとは何が違いますか？

data.gouv.frのMCPサーバーとnyambot-mcpは異なる役割を担っており、相互補完的です。

• datagouv-mcpはオープンデータのカタログを公開します。データセットを検索し、リソースを一覧表示し、生の表形式データを照会できます。データ探索／分析ツールです。
• nyambot-mcpはすぐに使える業務上の回答を提供します。質問（自治体のリスク、住宅のDPEなど）をすると、どのデータセットや列を使うか知らなくても、活用可能な結果が得られます。意思決定ツールです。

	datagouv-mcp（公式）	nyambot-mcp
レベル	カタログと生のデータセット	厳選された業務上の回答
ソース	data.gouv.frのみ	複数ソース：Géorisques、BAN、geo.api.gouv.fr、ADEMEなど（ネイティブAPI、data.gouvのカタログ外）
エージェントに必要な作業	データセットを探し、列を推測し、クエリを組み立てる	…ツールを呼び出すだけ
代表的な用途	「Xに関するデータセットを探して」	「この物件にリスクはありますか？DPEは何ですか？」
信頼性	推測したスキーマに依存	事前設定済み：1回の呼び出しで1つの回答

両方を接続できます。 任意のデータセットの探索にはdatagouv-mcpを、価値の高い生活上のケース（不動産、権利など）に関する迅速な回答にはnyambot-mcpを使えます。ホスト型コネクター（mcp.nyambot.ai/mcp、オンライン）では、独自の解釈機能も利用できます。Service-Publicの情報シートのRAG、Légifranceの正確な条文、実際のDVF市場データ、情報源を完全に明記した回答を提供します。

---

インストール

前提条件

uvがインストールされていること（推奨）。それ以外の場合は、後述の「ソースから」をご覧ください。

Claude Desktop

claude_desktop_config.jsonに以下を追加してください。

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

その後、Claude Desktopを再起動してください。uvxがサーバーを自動でダウンロードして起動するため、ほかにインストールするものはありません。

Claude Code

プロジェクトのルートにある.mcp.jsonに以下を追加してください。

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

または、次のコマンドを実行してください。

claude mcp add nyambot -- uvx nyambot-mcp

Cursor / VS Code / Windsurf

上記と同じ mcpServers ブロックを、エディターの MCP 設定に追加します。

ソースから（PyPI 公開前）

{
  "mcpServers": {
    "nyambot": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/GabMJ23/nyambot-mcp", "nyambot-mcp"]
    }
  }
}

---

質問の例

接続したら、エージェントに次のように尋ねてみてください。

• 「Combs-la-Ville の INSEE コードは何ですか？」
• 「Pierrelatte で購入する前に確認すべき自然災害リスクは何ですか？」
• 「75011 周辺の DPE を教えてください。」
• 「Amiens の boulevard du Port 8 番地の物件を購入しようと考えています。住所をジオコーディングして、自治体のリスクを一覧にしてください。」

実際の回答例 — 無料コネクター経由の risques_immobilier("Pierrelatte")：

Risques recensés pour Pierrelatte (INSEE 26235) :
- Effet toxique
- Inondation
- Mouvement de terrain
- Nucléaire
- Risque industriel
- Séisme
- Transport de marchandises dangereuses

---

接続を確認する

• Claude Code：claude mcp list（ステータスが connected）またはセッション内で /mcp。
• 呼び出しを確認するデバッグモード：claude --debug。

---

開発

git clone https://github.com/GabMJ23/nyambot-mcp
cd nyambot-mcp
uv venv && uv pip install -e ".[dev]"

# Lancer les tests (offline, sans réseau)
pytest

# Lancer le serveur localement
nyambot-mcp

---

オープンソースのコア（このパッケージ）とホスト型コネクター（オンライン）

nyambot-mcp は無料のオープンソース部分です。キー不要で、ローカルで国の公開 API を直接呼び出すコネクターです（自治体、ジオコーディング、リスク、DPE の 4 つのツール）。

ホスト型コネクター — https://mcp.nyambot.ai/mcp、オンライン — は、フランスの行政に関するすぐに使える 21 のツールを統合しています。これには、セマンティックソースやホスト型インフラストラクチャが必要なもの（セルフホスト不可）も含まれます。

• 🏠 実際の DVF 不動産市場データ — 実際に成立した取引に基づく €/m² の中央値
• ⚖️ Légifrance — 正確な法令条文、最新の本文
• 💼 SIRENE / INSEE（企業確認）、Annuaire Santé (ANS)、France Travail
• 📚 Service-Public の案内記事の RAG（セマンティック検索）
• ✍️ 行政文書の生成、支援制度のシミュレーション
• …その他 — すべて構造化され、出典が完全に明記された回答です。

利用方法：

• 対話形式での利用（人が操作するエージェント — Claude、ChatGPT、Cursor など）：クライアントを https://mcp.nyambot.ai/mcp に接続します。OAuth 2.1（PKCE）による接続が管理され、初回呼び出し時に認証画面が開きます。
• バックエンド連携／サーバー間通信：マシンキー（OAuth の client credentials）を申請に応じて発行します。client_id と client_secret をお渡しします。トークンを取得し、Bearer でコネクターを呼び出してください。

内部の仕組み（ホスト型プラットフォーム）：

• Claude (Anthropic) をベースに構築され、タスクに応じて Haiku / Sonnet を使い分けるマルチモデルルーティングを採用しています。
• 主権的に管理されたコーパス（Service-Public の案内記事、施行中の法令、data.gouv のカタログ）を対象とするハイブリッド検索（高密度検索＋語彙検索）。
• すぐに使える回答を提供する契約：1 回の呼び出しで出典付きの回答を 1 件返し、適切に機能を縮退させます（エージェントを停止させるエラーは発生しません）。

技術スタック（ホスト型プラットフォーム）：

Python 3.12 · FastAPI · MCP SDK (Streamable HTTP) · Anthropic SDK · PostgreSQL + pgvector（ベクトル検索）· 主権的に管理された bge-m3 埋め込み · Postgres の FTS（語彙検索）· SSE（リアルタイムストリーミング）· OAuth 2.1（PKCE + client credentials）· Alembic（マイグレーション）· Pydantic · httpx · Railway (UE) にデプロイ。

このリポジトリのオープンソースコネクターは、意図的に最小構成（Python + mcp + httpx）にしています。上記のインテリジェンス基盤はすべてホスト型プラットフォーム上で稼働します。

ローカルコネクターは今後もオープンソースかつ無料です。ホスト型の機能はバックエンド（OAuth／マシンキー）経由で利用できます。

ホスト型コネクターまたはバックエンドのマシンキーを接続したい場合は？ ご連絡ください（下記の「連絡先」をご覧ください）。

---

連絡先

質問、ご意見、API キー v2 の申請、パートナーシップのご相談：

Gabriel Mbenda — AI Builder & Founder, Nyambot.ai 📧 [email protected]

---

ライセンス

MIT © 2026 Gabriel Mbenda — Nyambot.aiのプロジェクトです。

データはフランス政府の公式ソース（オープンライセンス Etalab）から取得しています。Nyambotは独立したサービスであり、フランス政府とは提携していません。

---

mcp-name: io.github.GabMJ23/nyambot-mcp