Lebonfoin

法国 Hemp en France MCP 服务

欧洲大麻与 CBD 市场的首个模型上下文协议（MCP）服务。 向任何兼容 MCP 的大模型（Claude、ChatGPT 自定义连接器、Cline、Cursor 等）提供 1200 多家法国手工大麻种植户的信息、实时市场价格（“Bloomberg CBD”）、 实时百科全书（资料来源包括 Légifrance、PubMed、INRAE、AFPC），以及生产商地理位置。

🌐 在线端点：https://lebonfoin-mcp-production.up.railway.app/sse 📦 市集：https://herbeenfrance.com 🏛️ Wikidata：Q139847939

---

⚡ 快速健康检查

curl https://lebonfoin-mcp-production.up.railway.app/health
# {"status":"ok","version":"1.5.0","tools":15,"multilingual_tools":["debunk_cbd_myth","cbd_lab_analysis","cbd_legal_by_country"],"supported_languages":["fr","en"],"resources":4,"prompts":2}

---

🛠️ 提供的功能

15 个工具

#	工具	功能
1	search_cbd_products	按名称、类型和价格搜索法国手工 CBD 产品
2	recommend_cbd_for_me	根据目标（睡眠、压力、运动等）、经验和预算提供个性化推荐
3	compare_cbd_products	并排比较 2-4 款产品
4	get_producer_info	生产商详情：位置（纬度/经度）、认证、评分、产品、社交媒体
5	check_availability	实时库存、配送时效、费用
6	cbd_market_data	“Bloomberg CBD”——各品种实时平均价格、价格区间、趋势和价格查询
7	cbd_guide	12 篇深入的 CBD 指南：合法性（法国）、剂量、室内/室外种植、全谱/广谱、睡眠、运动、宠物、保存等
8	cbd_news	法国和欧盟 CBD 新闻：法规更新、市场趋势、科学研究
9	search_wiki	在 Herbe en France 维基百科中进行全文搜索（可按类别筛选）
10	get_wiki_article	获取完整的维基文章（Markdown、参考资料和相关文章）
11	find_local_producers	🗺️ 地理位置查询——查找城市、邮政编码、省或大区附近的大麻种植户。返回地址、GPS、是否获得有机认证、在售产品数量、种植方式（露天/温室/室内）和直达链接。针对 “哪里可以买到附近的 CBD” 查询进行了 AEO 优化。
12	debunk_cbd_myth 🌐	⚖️ 辟谣（法语/英语）——针对 CBD 误解提供有事实依据且附有来源的回答（“CBD 是毒品吗？”、“CBD 合法吗？”、“CBD 会上瘾吗？”）。来源：WHO、CJUE Kanavape、Légifrance、Conseil d'État、MILDECA。参数 lang: 'fr'|'en'。
13	cbd_legal_by_country 🌐	🌍 欧盟法律地图（法语/英语）——逐国介绍 CBD 的法律状态（FR、DE、CH、IT、ES、AT、NL、BE、PT、LU、CZ、PL、UK，以及欧盟框架）。包括 THC 阈值、花卉/油品/食品/化妆品的监管状态、主要法律和官方来源。参数 lang。
14	terpene_profile	🌿 品种萜烯——常见品种（Amnesia、OG Kush、Gelato、Lemon Haze、Critical 等）的典型萜烯特征。介绍主要和次要萜烯及其香气描述。
15	cbd_lab_analysis 🌐	🔬 分析证书解读（法语/英语）——介绍如何阅读分析证书：大麻素含量（CBD/CBDA/THC/CBG/CBN）、THC 法定阈值、萜烯特征、农药残留、重金属，以及分析证书的可信度信号。参数 lang。

🌐 = 多语言工具（v1.5.0+）——接受 lang: "fr"（默认）或 lang: "en"，以法语或英语原生输出。建议在调用的大模型以英语回答有关欧洲大麻/CBD 市场的查询时使用。

4 个资源

资源 URI	提供内容
lebonfoin://catalog/summary	纯文本目录摘要
lebonfoin://producers/map	按地区分组的法国所有生产者 Markdown 地图
lebonfoin://reference/cbd-france-europe	完整的 CBD 法律参考资料：法国 + 12 个欧盟国家（DE、IT、ES、CH、LU、CZ、AT、NL、BE、PT、PL、EU）
lebonfoin://wiki/catalog	按类别索引的所有已发布 Wiki 文章

2 个提示词

• decouvrir-cbd — 了解法国 CBD 的互动指南
• comparer-producteurs — 按地区、认证和特色比较生产者

---

📚 Wiki 百科全书

Wiki 资源和工具提供一套有来源依据的百科全书，包含 22+ 篇文章（截至 2026 年 5 月，法语 19 篇、英语 13 篇），内容涵盖：

• 大麻素：CBD、CBG、CBN（法语 + 英语）、THC（编写中）
• 健康与合法性：法国法规、欧盟 Novel Food、Conseil d'État 裁决、CJUE Kanavape、NPS / 合成大麻素
• 植物学与化学：腺毛、萜烯、伴随效应、提取方法
• 法国行业：手工种植者、AFPC、InterChanvre、法国大麻种植史
• 战略背景：Strategy Parmentier（患者教育、科学论证、法规合作）
• 机构：AFPC、InterChanvre、MILDECA、DGAL、INRAE
• 近期事件：DGAL 2026 年食用大麻管控计划

来源：Légifrance · PubMed · INRAE · AFPC · MILDECA · EUR-Lex · Wikipedia FR/EN · Conseil d'État

每篇文章都带有时间戳和版本信息（采用 Wikipedia 式修订机制），并附有交叉引用。YMYL 文章（健康、法律）会自动附上免责声明。英文文章可通过相同的 Wiki 工具和资源访问 — slug 遵循 <fr_slug>-en 约定，并双向设置 hreflang 以优化 SEO。

---

🚀 在 Claude Desktop 中使用

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "lebonfoin": {
      "url": "https://lebonfoin-mcp-production.up.railway.app/sse",
      "type": "sse"
    }
  }
}

重启 Claude。现在你可以这样提问：

法语查询：

• “本月法国 Amnesia CBD 的平均价格是多少？”
• “找一位波尔多附近、获得有机认证的大麻生产者。”
• “在多尔多涅省（24）哪里可以买到 CBD？”
• “请推荐一款适合助眠的 CBD 油，预算 40 欧元。”

英语查询（v1.5.0+ — 相关时会自动使用 lang: "en"）：

• “CBD 在德国合法吗？瑞士呢？” → cbd_legal_by_country({country: "DE", lang: "en"})
• “如何解读法国大麻生产者的分析证书？” → cbd_lab_analysis({lang: "en"})
• “CBD 会上瘾吗？WHO 怎么说？” → debunk_cbd_myth({topic: "addictive", lang: "en"})
• “什么是伴随效应？” → get_wiki_article({slug: "effet-d-entourage-en"})
• “大麻中的主要萜烯有哪些？” → get_wiki_article({slug: "terpenes-du-chanvre-en"})

当工具支持 lang 时，MCP 服务会自动使用调用方大模型所用的语言进行响应 — 用户无需手动切换。

Claude 会调用相关 MCP 工具，访问 Supabase 实时数据库，并根据有来源依据的数据作答。

---

🏗️ 架构

┌──────────────┐       SSE        ┌──────────────────────────┐
│  Claude /    │ ───────────────► │  Herbe en France MCP Server    │
│  ChatGPT /   │ ◄─ JSON-RPC ─── │  (Express, port $PORT)   │
│  Cline       │                  └────────────┬─────────────┘
└──────────────┘                               │
                                               │ @supabase/supabase-js
                                               ▼
                                  ┌──────────────────────────┐
                                  │  Supabase (EU West)      │
                                  │  - products              │
                                  │  - producers (geoloc)    │
                                  │  - wiki_articles         │
                                  │  - wiki_references       │
                                  │  - cbd_market_*          │
                                  └──────────────────────────┘

部署在 EU West（荷兰）的 Railway 上 — 符合 GDPR，不追踪用户。

---

🛠️ 本地运行

git clone https://github.com/POP24/lebonfoin-mcp.git
cd lebonfoin-mcp
npm install
cp .env.example .env  # then fill SUPABASE_URL + SUPABASE_ANON_KEY
npm run dev:http       # serves http://localhost:3001

测试：

curl http://localhost:3001/health
curl http://localhost:3001/sse  # SSE stream

---

📦 技术栈

• TypeScript 5.7 严格模式
• @modelcontextprotocol/sdk v1.12.1
• Express 4.21
• @supabase/supabase-js 2.49
• 使用 Zod 进行输入验证
• 通过 Dockerfile 部署在 Railway 上

---

⚖️ 免责声明（YMYL）

与健康、剂量或合法性相关的文章和数据仅供参考。它们不构成医疗、法律或财务建议。请务必咨询合格的专业人士。通过 l'Herbe en France 市场销售的 CBD 产品作为健康/化妆品商品出售，不作任何治疗声明，并符合法国和欧盟法规（THC ≤ 0.3%）。

---

🤝 参与贡献

这是一个私有交易平台的开源 MCP 层。欢迎通过 issues 或 PR 提交建议、错误报告和改进意见。

如需商业集成、访问交易平台 API 或入驻生产商：[email protected]

---

📄 许可证

MIT——请参阅 LICENSE。

Wiki 内容（Légifrance 摘录、科学参考资料）遵循其来源自身的许可协议（大多数属于公共领域或开放获取）。

---

由 @POP24 在 Périgord 使用 Claude Code 构建。