nyambot-mcp

nyambot-mcp

让法国公共数据可供您的 AI Agent 使用的智能层。

法国公共数据是开放的——但原始、分散在数十个 API 中，而且放在上下文中难以理解。真正的挑战不是访问数据，而是理解数据：对于当前的具体情况，应该选用哪个数据集、哪一列，又该如何解读。Nyambot 正是为此而生：它是一个智能系统，代替您的 Agent 完成这项工作——它会查询、交叉比对、结合上下文，并返回附带来源且可直接使用的答案，而不是需要解析的 CSV 行。

您的 AI（Claude、ChatGPT、Le Chat……）不了解法国：单独使用时，它只会改述读过的内容，没有日期，也没有来源。接入 Nyambot 后，它会在您提问的那一刻查询政府数据，并注明来源。

▶ 完整的 Nyambot Agent 已上线——立即体验：nyambot.ai

示例：您的 Agent 依次调用 resolve_commune → risques_immobilier → dpe_logement，几秒内就能对一处房产给出有理有据的结论——而原始 API 只会返回需要自行解读的表格。

• 🧠 提供答案，而非数据行。 一次调用 = 一个可直接使用的业务答案——无需知道该查询哪个数据集或哪一列。
• 📎 有据可查，不会产生幻觉。 每个答案都附有官方来源（日期、参考信息、金额）。
• 🆓 免费，无需 API 密钥，适用于这个开源核心——通过 uvx 一行命令即可安装。
• 📖 开源，采用 MIT 许可证。

此软件包 = 无需密钥的开源核心（4 个工具，在本地运行）。 如需完整版本——21 个工具（真实 DVF 房产市场、Légifrance、SIRENE、Service-Public 资料卡、补助……），可获取即用型且有来源依据的答案：托管连接器已上线 → https://mcp.nyambot.ai/mcp（OAuth 2.1）。后端 / 服务器到服务器集成（机器密钥）可按需提供。详情见下文。

---

为什么选择 Nyambot——改变游戏规则

在法国，每年有数十亿欧元的权益无人申领——并非因为不符合资格，而是因为行政流程如同迷宫。问题从来不是无法访问数据（数据是公开的），而是如何在具体情境中正确理解数据，避免出错。这正是 Nyambot 智能层的工作——而仅仅访问原始 API，永远无法做到这一点。

Nyambot.ai 是一个 AI Agent，不只是提供信息，还会代办手续；它以政府官方数据为依据，每个答案都有来源，不会产生幻觉。通用聊天机器人会编造信息，公共门户网站又无法提供帮助，而Nyambot 会采取行动。

它涵盖人生各类事务——身份证、税务、驾照、车辆登记证、补助与津贴、搬家、继承、创办企业、房产……nyambot-mcp 将其中一部分能力开放给您自己的 AI Agent。

房地产，即时展开

在完整 Agent（nyambot.ai）上，一个像 “Pierrelatte 的这套房子售价 286 000 €，位置合适吗？” 这样的问题会触发逐步可见的分析——Agent 会查找 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² 计算，该房产价格比当地中位数高约 34%（来源：DVF，38 套可比房产成交记录）——DPE A 评级或可解释这一价格，但仍有议价空间。注意事项：需核实建筑是否位于黏土灾害风险区。

数秒内查找官方数据、展开数据、交叉分析，并注明来源。通用聊天机器人做不到这一点。

**v2 已上线。**托管连接器 mcp.nyambot.ai/mcp 可访问所有实时的法国公共数据——行政办事指南、真实的房地产每平方米价格（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 目录中）
Agent 需要……	找到数据集、猜测列名、构建查询	……只需调用工具
典型用例	“帮我找找关于 X 的数据集”	“这处房产有风险吗？它的 DPE 是什么？”
可靠性	取决于猜测的架构	预先配置：一次调用 = 一个答案

两者可以同时接入。使用 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

在编辑器的 MCP 配置中使用与上文相同的 mcpServers 块。

从源代码安装（发布到 PyPI 之前）

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

---

问题示例

连接完成后，可以向你的 Agent 提问：

• “Combs-la-Ville 的 INSEE 代码是什么？”
• “在 Pierrelatte 购房前，需要注意哪些自然灾害风险？”
• “给我一些 75011 附近的 DPE。”
• “我打算购买亚眠港口大道 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 的连接器，无需密钥，在本地运行（4 个工具：市镇、地理编码、风险、DPE）。

托管连接器——https://mcp.nyambot.ai/mcp，在线运行——整合了面向法国行政事务的 21 个 answer-ready 工具，包括需要语义数据源和托管基础设施的工具（无法自托管）：

• 🏠 真实 DVF 房地产市场数据——已实际成交交易的 €/m² 中位数
• ⚖️ Légifrance——准确的法律条文及最新文本
• 💼 SIRENE / INSEE（企业核验）、Annuaire Santé (ANS)、France Travail
• 📚 Service-Public 资料的 RAG（语义搜索）
• ✍️ 行政信函生成、补助模拟
• ……以及更多功能——全部以结构化且有完整来源依据的形式作答。

如何使用：

• 交互式使用（由人操作的 Agent——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 目录）上进行混合搜索（稠密搜索 + 词法搜索）。
• answer-ready 契约：一次调用 = 一个有来源依据的回答，并提供诚实的降级处理（绝不会因错误而中断你的 Agent）。

技术栈（托管平台）：

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（欧盟）。

此仓库中的开源连接器将继续保持精简（Python + mcp + httpx）：以上所有智能基础设施均运行在托管平台上。

本地连接器将继续开源且免费；托管功能通过后端提供（OAuth / 机器密钥）。

想要接入托管连接器或后端机器密钥？ 请给我写信（联系方式见下文）。

---

联系方式

问题、反馈、申请 v2 API 密钥或商务合作：

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

---

许可证

MIT © 2026 Gabriel Mbenda — 一个 Nyambot.ai 项目。

数据来自法国政府官方来源（Etalab 开放许可证）。Nyambot 是一项独立服务，与法国政府无关联。

---

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