Demo

<div align="center">
<a href="https://youtube.com/shorts/SmN-I3XBO0g?si=bg4PqM5TJTMWdtGJ">Short Demo Video</a>
</div>

Setup

1. Run npx @gutmutcode/mcp-server-cloudflare init

<div align="left">

</div>

2. Restart Claude Desktop, you should see a small 🔨 icon that shows the following tools available for use:

<div align="left">


</div>

3. Check out the Cline configuration file, you should see a cloudflare section with your Cloudflare account ID.

<div align="left">

</div>

4. Check out your Windsurf MCP configuration file, you should see a cloudflare section either. Windsurf has limitation on the use of MCP tools, so you can't use too many tools at the same time. (Unlike Cline and Claude)

<div align="left">

</div>

Features

KV Store Management

R2 Storage Management

D1 Database Management

Workers Management

Analytics

Developing

In the current project folder, run:

pnpm install
pnpm build:watch

Then, in a second terminal:

node dist/index.js init

This will link Claude Desktop against your locally-installed version for you to test.

Usage outside of Claude

To run the server locally, run node dist/index run <account-id>.

If you're using an alternative MCP Client, or testing things locally, emit the tools/list command to get an up-to-date list of all available tools. Then you can call these directly using the tools/call command.

Workers

// List workers
worker_list()
// Get worker code

worker_get({ name: "my-worker" })
// Update worker

worker_put({

  name: "my-worker",

  script: "export default { async fetch(request, env, ctx) { ... }}",

  bindings: [

    {

      type: "kv_namespace",

      name: "MY_KV",

      namespace_id: "abcd1234"

    },

    {

      type: "r2_bucket",

      name: "MY_BUCKET",

      bucket_name: "my-files"

    }

  ],

  compatibility_date: "2024-01-01",

  compatibility_flags: ["nodejs_compat"]

})
// Delete worker

worker_delete({ name: "my-worker" })

KV Store

// List KV namespaces
get_kvs()
// Get value

kv_get({

    namespaceId: "your_namespace_id",

    key: "myKey"

})
// Store value

kv_put({

    namespaceId: "your_namespace_id",

    key: "myKey",

    value: "myValue",

    expirationTtl: 3600 // optional, in seconds

})
// List keys

kv_list({

    namespaceId: "your_namespace_id",

    prefix: "app_", // optional

    limit: 10 // optional

})
// Delete key

kv_delete({

    namespaceId: "your_namespace_id",

    key: "myKey"

})

R2 Storage

// List buckets
r2_list_buckets()
// Create bucket

r2_create_bucket({ name: "my-bucket" })
// Delete bucket

r2_delete_bucket({ name: "my-bucket" })
// List objects in bucket

r2_list_objects({ 

    bucket: "my-bucket",

    prefix: "folder/", // optional

    delimiter: "/", // optional

    limit: 1000 // optional

})
// Get object

r2_get_object({

    bucket: "my-bucket",

    key: "folder/file.txt"

})
// Put object

r2_put_object({

    bucket: "my-bucket",

    key: "folder/file.txt",

    content: "Hello, World!",

    contentType: "text/plain" // optional

})
// Delete object

r2_delete_object({

    bucket: "my-bucket",

    key: "folder/file.txt"

})

D1 Database