cloudflare/mcp

解決する課題

このプロジェクトは、2,500以上のエンドポイントを含む膨大な Cloudflare API と AI エージェントがやり取りするための、トークン効率の高い方法を提供します。従来の Model Context Protocol (MCP) サーバーは、通常、すべてのエンドポイントを個別のツールとして公開するため、コンテキストウィンドウのスペースを数百万トークン消費してしまいます。このサーバーは、そのオーバーヘッドを数百万トークンから約 1,000 トークンに削減します。

仕組み

すべての API エンドポイントをツールとしてリストアップする代わりに、このサーバーは「Code Mode」パターンを使用します。AI エージェントは完全な API 仕様を受け取るのではなく、主に以下の 3 つのツールを使用します。

• docs: Cloudflare の開発者ドキュメントを検索します。
• search: エージェントが JavaScript コードを記述して、サーバー側で API 仕様を照会し、正しいエンドポイントを見つけることを可能にします。
• execute: エージェントが JavaScript を記述して、発見された Cloudflare API エンドポイントを呼び出すことを可能にします。

サーバーは、Dynamic Worker Loader API を使用して、隔離された Workers 内でこのコードを実行します。

対象者

LLM 駆動のエージェントを使用して、エージェントのコンテキストウィンドウを使い果たすことなく、Cloudflare サービス（Workers、KV、R2、D1、Pages、DNS など）を自動化したい開発者および AI エージェントのユーザー。

ハイライト

• 極めて高いトークン効率: コンテキスト使用量を約 200 万トークン（生の OpenAPI 仕様）から約 1,000 トークンに削減します。
• Code Mode サポート: API の検出と実行のロジックをサーバー側の JavaScript 実行に移行します。
• 幅広い API カバレッジ: GraphQL Analytics API を含む、ほぼすべての Cloudflare 製品をサポートしています。
• 柔軟な認証: OAuth と API トークンの両方をサポートしています。
• オプションのネイティブモード: 必要に応じて、クエリパラメータを介して無効化し、従来の MCP ツール登録に戻すことができます。