Skip to content

Latest commit

 

History

History

README.md

Cloudflare Workers Bindings MCP Server

This is a Model Context Protocol (MCP) server that supports remote MCP connections, with Cloudflare OAuth built-in.

It integrates tools for managing resources in the Cloudflare Workers Platform, which you can connect to your Worker via Bindings.

The /mcp and /sse URLs use the same stateless SDK v2 handler and create a fresh server with request-scoped auth/account context for every request. /sse is not the deprecated HTTP+SSE transport. OAuth and product bindings remain application/security state; no MCP protocol session or protocol Durable Object is retained.

🔨 Available Tools

Currently available tools:

Category Tool Description
KV Namespaces kv_namespaces_list List all of the kv namespaces in your Cloudflare account
kv_namespace_create Create a new kv namespace in your Cloudflare account
kv_namespace_delete Delete a kv namespace in your Cloudflare account
kv_namespace_get Get details of a kv namespace in your Cloudflare account
kv_namespace_update Update the title of a kv namespace in your Cloudflare account
Workers workers_list List all Workers in your Cloudflare account
workers_get_worker Get the details of a Cloudflare Worker
workers_get_worker_code Get the source code of a Cloudflare Worker
R2 Buckets r2_buckets_list List r2 buckets in your Cloudflare account
r2_bucket_create Create a new r2 bucket in your Cloudflare account
r2_bucket_get Get details about a specific R2 bucket
r2_bucket_delete Delete an R2 bucket
D1 Databases d1_databases_list List all of the D1 databases in your Cloudflare account
d1_database_create Create a new D1 database in your Cloudflare account
d1_database_delete Delete a d1 database in your Cloudflare account
d1_database_get Get a D1 database in your Cloudflare account
d1_database_query Query a D1 database in your Cloudflare account
Hyperdrive hyperdrive_configs_list List Hyperdrive configurations in your Cloudflare account
hyperdrive_config_create Create a new Hyperdrive configuration in your Cloudflare account
hyperdrive_config_delete Delete a Hyperdrive configuration in your Cloudflare account
hyperdrive_config_get Get details of a specific Hyperdrive configuration in your Cloudflare account
hyperdrive_config_edit Edit (patch) a Hyperdrive configuration in your Cloudflare account

This MCP server is still a work in progress, and we plan to add more tools in the future.

Prompt Examples

  • List my Cloudflare accounts.
  • Show me my KV namespaces.
  • Create a new KV namespace called 'my-kv-store'.
  • Get the details for KV namespace 'YOUR_NAMESPACE_ID'. (Replace YOUR_NAMESPACE_ID)
  • Delete the KV namespace 'NAMESPACE_TO_DELETE_ID'. (Replace NAMESPACE_TO_DELETE_ID)
  • List my Cloudflare Workers.
  • Get the code for the 'my-worker-script' worker.
  • Show me my R2 buckets.
  • Create an R2 bucket named 'my-new-bucket'.
  • Get details for the R2 bucket 'my-data-bucket'.
  • Delete the R2 bucket 'old-bucket'.
  • List my D1 databases.
  • Create a D1 database named 'analytics-db'.
  • Get details for D1 database 'YOUR_D1_DB_ID'. (Replace YOUR_D1_DB_ID)
  • Run the query 'SELECT * FROM customers LIMIT 10;' on D1 database 'YOUR_D1_DB_ID'. (Replace YOUR_D1_DB_ID)
  • Delete the D1 database 'TEMP_DB_ID'. (Replace TEMP_DB_ID)
  • List my Hyperdrive configurations.
  • Create a Hyperdrive config named 'prod-db-cache' for my database. (You might need to provide more origin details)
  • Get details for Hyperdrive config 'YOUR_HYPERDRIVE_ID'. (Replace YOUR_HYPERDRIVE_ID)
  • Update the cache settings for Hyperdrive config 'YOUR_HYPERDRIVE_ID'. (Replace YOUR_HYPERDRIVE_ID)
  • Delete the Hyperdrive config 'OLD_HYPERDRIVE_ID'. (Replace OLD_HYPERDRIVE_ID)

Connect to the MCP server

Connect your MCP client directly to https://bindings.mcp.cloudflare.com/mcp. If prompted, complete the Cloudflare OAuth flow in your browser. The tools become available after authorization.

Interested in contributing, and running this server locally? See CONTRIBUTING.md to get started.