Cloudflare MCP ServerでClaude Desktop からWeb APIを構築

Cloudflare MCP Server を使って Claude Desktop から Cloudflare Workers で Web APIを構築

1. Cloudflare MCP ServerでClaude Desktop からWeb APIを構築してみた Taku Yoshida (FrontierTech 合同会社)
2. 2 スピーカー紹介 吉田 拓 • テクノロジーで "はじめる" を "ささえる" を掲げる FrontierTech 社 CEO • 最近ハマってる遊び: ポーカー、o1 pro mode に10~30年 後に発見される概念(妄想)を考えてもらうこと FrontierTech CEO
3. 3 もう少し詳しく https://zenn.dev/kutakutat/scraps/b7747379dc6033
4. 4 モチベーション 📢 Anthropic がなにやら "MCP" っていう概念を発表した 💡 Claude Desktop を離れずに Cloudflare Workers にスクリプトをデ プロイできるらしい 👉 (実用性はともかく ) まずはやってみたい !!
5. 5 MCP(Model Content Protocol) とは https://modelcontextprotocol.io/introduction MCP は、AI アプリケーション用の USB-C ポートのようなものです。 USB-C がデバイスをさまざまな周辺機器やアクセサリに接続するための標準化された方法を提供するの と同様に、MCP は AI モデルをさまざまなデータ ソースやツールに接続するための標準化された方法を提 供します。 Model Content Protocol(MCP) は、LLM アプリケーションと外部データ ソースおよびツールとのシー ムレスな統合 を可能にするオープンプロトコル です。 AI 搭載 IDE の構築、チャット インターフェイスの強化、カスタム AI ワークフローの作成など、どのような場 合でも、MCP は LLM を必要なコンテキストに接続するための標準化された方法を提供 します。 https://spec.modelcontextprotocol.io/specification/
6. 6 Claude Desktop、IDE、または MCP を介してリソースにアク セスする AI ツールなどのプログラム MCP Host MCPを活用した一般的なアーキテクチャーの例 Server との 1:1 接続を維持するプロトコルクライアント MCP Client 標準化されたプロトコルを通じて特定の機能を公開する軽量 プログラム (仕様上はリモートにあってもOK) MCP Server
7. 7 MCP に対応した Host, Client 機能が実装されたデスクトップアプリ。 claude.ai では利用できない。 ※ Claud Desktop では現在マシン上で実行されているローカル MCP Server への接続のみをサポートしている。 Claude Desktop Claude Desktop: MCP Host, Client の代表格 公式ドキュメントにある MCP 対応した Client の一覧
8. 8 MCP 仕様の概要 MCP Client MCP Server Sampling サーバーからクライアントの LLMを使える機能 Tool モデルが実行できるアクションを提供する機能 Prompt プロンプトテンプレート機能 Resource データやコンテンツを提供する機能 JSON-RPC 形式 ステートフルな接続 どの機能を使うかの交渉 MCP Client が機能に対応していれば MCP Server そのままに Client を 切り替えられる (逆もしかり) Roots サーバーからクライアントの ファイルシステムのルートを使える機能
9. 9 Claude Desktop とサーバ機能 Tool モデルが実行できるアクションを提供する機能 Resource データやコンテンツを提供する機能 Prompt プロンプトテンプレート機能
10. 10 Claude Desktop とサーバ機能 Tool モデルが実行できるアクションを提供する機能 Prompt プロンプトテンプレート機能 Resource データやコンテンツを提供する機能
11. 11 Tool を利用する流れ 結果をLLMが利用 Clientから指示 サーバから提供された Toolsを一覧化 LLMがToolを選ぶ サーバの Toolを使用(コール)する
12. 12 PC やりたかったこと MCP Server Cloudflare MCP Server MCP Host Claude Desktop MCP Client Cloudflare API スクリプトの作成 Cloudflare Workers の作成 スクリプトのデプロイ
13. 13 Cloudflare 公式の MCP Server を利用する セットアップ手順 1. npx @cloudflare/mcp-server-cloudflare init を実行 2. /Library/Application Support/Claude/claude_desktop_config.json に設定が追加される 3. Cloud Desktop を再起動
14. 14 mcp-server-cloudflare の中身(とても雑な紹介 ) サーバから提供された Toolsを一覧化 worker_list Toolを使用(コール)する
15. 実行!
16. 16 作成中...
17. 17 …完成
18. 18 たしかにできている !
19. 19 作成されているスクリプトの中身
20. 20 PC やりたかったこと MCP Server Cloudflare MCP Server MCP Host Claude Desktop MCP Client Cloudflare API スクリプトの作成 Cloudflare Workers の作成 スクリプトのデプロイ
21. 21 本当はやりたかったこと : Hono を使用する もともとはさくっと Hono の API 立てられたら最高 ! と思っていた Cloudflare Workers にファイルをアップする時に、コードの中身がそのままリクエストに展開されるように なっている Claude から MCP Client 経由で Toolコールする際にバンドルしたファイルがトークンの上限にひっかかり 実行できなかった ※ Hono は十分に軽量で非常にすきなライブラリです。あくまでトークンの上限に対して 当初想定の流れ 1. ✅ Fetch MCP Server で Hono のクイックスタートを URL を渡してよみこむ 2. ✅ Claude にサンプルコードを作成してもらう 3. ✅ Filesysytem MCP Server でローカル PC の特定のディレクトリにコードを置く 4. ✅ (Claude Desktop を離れ) npx wrangler deploy --dry-run --outdir dist でバンドル (Claude Desktop に戻る) 5. ✅ Filesysytem MCP Server でバンドルした成果物のパスを指定して読み込んでもらう 6. ❌ Cloudflare MCP Server で Cloudflare Workers にコードをあげる
22. まとめ MCPはLLMをデータやツールに接続するための標準化された仕様 MCP Server を作れば Cloudflare連携、ファイル連携などいろい ろできてLLMがいい感じに制御してくれる オープンな仕様なのでサーバー /クライアント増える可能性 + 仕様にはもっと広範な内容があり今後も期待 ! Sampling すごそう