mcp-compteparticulier

mcp-compteparticulier

compteparticulier.com のカタログを AI エージェントに公開する、読み取り専用の MCP（Model Context Protocol） サーバーです。銀行、保険会社、共済、エネルギー、通信、ストリーミング、公共サービス、商業など、フランスのブランドや行政機関の顧客アカウントにログインする手順を、ステップごとに解説するガイドを提供します。

エンドポイント

サーバーはすでにデプロイ済みで、認証は不要です。

トランスポート	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 はありません。そのため、サーバーはビルド時に生成される次の2つの公開リソースを読み込みます。

• /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 にはバージョン4の @cloudflare/workers-types が必要ですが、最近のバージョンの wrangler ではバージョン5が必要です。^ を使った範囲指定にすると、インストール時にこの競合が発生します。そのため、バージョンを上げる際は依存関係ツリー全体を確認する必要があります。

技術スタック

Cloudflare Workers + Durable Objects（MCP セッション）+ 公式 MCP SDK + Zod。 エッジキャッシュは1時間、レート制限は1 IP あたり毎分100リクエストです。

ライセンス

MIT