mcp-compteparticulier

mcp-compteparticulier

只读的 MCP（Model Context Protocol） 服务，向 AI Agent 提供 compteparticulier.com 的目录：帮助用户登录法国品牌和政府机构客户专区的分步指南，涵盖银行、保险、互助保险、能源、电信、流媒体、公共服务和商业。

端点

服务已部署，无需身份验证：

传输方式	URL
Streamable HTTP	https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp
SSE	https://mcp-compteparticulier.ads-particulier-tn.workers.dev/sse

从 MCP 客户端连接

{
  "mcpServers": {
    "compteparticulier": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-compteparticulier.ads-particulier-tn.workers.dev/mcp"]
    }
  }
}

工具

search_articles

按关键词搜索指南，搜索范围包括标题、品牌、描述和文章正文。返回标题、slug、URL 和描述。

参数	类型
query	string	必填 — 例如「登录 EDF」
limit	number	可选，1-20，默认值为 10

排序时优先考虑完全匹配的品牌，其次是标题，然后是描述；正文仅作为辅助依据。若不进行这种加权，搜索「EDF」时，EDF ENR 的排名会与 EDF 相同。搜索不区分重音符号：「caisse epargne」可以找到「Caisse d'Épargne」。

get_article

根据通过 search_articles 获取的 slug，返回指南的完整内容。

参数	类型
slug	string	必填 — 例如「mon-compte-edf」

资源

compteparticulier://about — 网站的 llms.txt（简介和目录）。

工作原理

compteparticulier.com 是一个静态网站（Astro / Cloudflare Pages），没有 API。因此，服务会读取两个公开资源，它们均在构建时生成：

• /search-index.json — 全文索引：标题、slug、品牌、类别、描述、文章正文和问答；
• /llms.txt — 易读目录，作为「about」资源提供。

这两个文件都应用了与网站页面相同的日期筛选规则。计划发布或处于草稿状态的文章不会出现在其中，正如其页面不会生成一样：因此，服务无法公开尚未发布的内容，也不会返回 404 URL。

整个过程中不会涉及机密、身份验证或个人数据。

开发

npm install
npm run typecheck   # tsc --noEmit
npm run dev         # wrangler dev
npm run deploy      # wrangler deploy

依赖项版本均已锁定，而非使用版本范围。agents 要求 @cloudflare/workers-types 为 4.x 版本，而近期版本的 wrangler 则要求 5.x 版本：使用 ^ 版本范围会导致安装遇到冲突。因此，任何版本升级都必须检查整个依赖树。

技术栈

Cloudflare Workers + Durable Objects（MCP 会话）+ 官方 MCP SDK + Zod。 边缘缓存一小时；每个 IP 每分钟限流 100 次请求。

许可证

MIT