mcp-moncompte

mcp-moncompte

Cloudflare Workers にデプロイされた、moncompte.org の記事カタログを AI エージェント（Claude など）に公開する読み取り専用の MCP（Model Context Protocol） サーバーです。

• スタック：TypeScript + Cloudflare Workers + Durable Objects + MCP 公式 SDK + Zod
• データソース：静的サイト moncompte.org（Astro / Cloudflare Pages）の公開エンドポイント — WP REST は使用しません。検索と get_article はどちらも /search-index.json（ビルド時に生成される全文検索インデックス：タイトル、slug、説明、本文全体）を読み込みます。リソース about は /llms.txt をプロキシします。シークレットは不要です。
• キャッシュ：各呼び出しで Cloudflare エッジに 1 時間キャッシュ

依存関係：search_articles と get_article は、Astro サイトで生成される https://moncompte.org/search-index.json（エンドポイント src/pages/search-index.json.js）を使用します。このインデックスには、未来の日付の記事（isPublished）と下書き（draft）はすでに含まれていないため、MCP が取得できるのは実際に公開されているコンテンツのみです。インデックスはサイトのビルド／デプロイのたびに再生成されます。

公開されるツールとリソース

種類	名前	役割
ツール	search_articles	キーワード検索（タイトル、slug、URL、抜粋）
ツール	get_article	記事の全文（slug で指定）
リソース	moncompte://about	moncompte.org の llms.txt をプロキシ

エンドポイント

• /sse — Server-Sent Events（従来のクライアント向け）
• /mcp — Streamable HTTP（推奨トランスポート）
• レート制限：IP ごとに 60 秒あたり 100 リクエスト（Workers のネイティブバインディング）
• Durable Object：NoticielMCP（McpAgent クラス）

開発

npm install
npm run dev          # wrangler dev (local)
npm run typecheck    # tsc --noEmit

デプロイ

npx wrangler login   # une fois (compte Cloudflare)
npm run deploy       # wrangler deploy

レート制限バインディング（[[unsafe.bindings]] の type ratelimit）には Wrangler ≥ 4.36 が必要です。 Durable Object McpAgent は SQLite ストレージ（マイグレーション new_sqlite_classes）を使用します。

MCP クライアントの接続

• URL：https://mcp-moncompte.<ton-sous-domaine>.workers.dev/mcp（または /sse）
• Claude Desktop / その他：mcp-remote 経由：

{
  "mcpServers": {
    "moncompte": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-moncompte.<sous-domaine>.workers.dev/sse"]
    }
  }
}

注意事項

• 書き込み操作はありません。このサーバーは moncompte.org の公開 API を読み取るだけです。
• agents と @modelcontextprotocol/sdk のバージョンは頻繁に更新されます。ビルドエラーが発生した場合は、npm install agents@latest @modelcontextprotocol/sdk@latest を実行してください。