📌Overview

Purpose: The Model Context Protocol (MCP) aims to standardize the management of context between large language models (LLMs) and external systems, specifically for interactions with Cloudflare's services.

Overview: The MCP Server facilitates natural language interactions with Cloudflare's API, allowing users to perform a variety of tasks related to their Cloudflare accounts seamlessly using LLMs like Claude Desktop or any other MCP Client.

Key Features:

KV Store Management: Provides comprehensive commands to manage key-value stores, including listing namespaces, retrieving, storing, and deleting key-value pairs.
R2 Storage Management: Enables users to manage R2 buckets by listing, creating, deleting, and operating on objects within these buckets.
D1 Database Management: Allows for easy handling of D1 databases, including listing databases, querying, creating, and deleting.
Workers Management: Simplifies the management of Workers by enabling users to list, retrieve, update, and delete worker scripts.
Durable Objects Management: Offers commands to manage Durable Objects namespaces and instances.
Queues System: Facilitates queue management, including creating, retrieving, and deleting queues along with their messages.
AI Integration: Provides access to available AI models and the ability to run inference using Workers AI.
Workflows Management: Supports the creation, deletion, and execution of workflows.
Templates Management: Allows users to list, get, and create workers from predefined templates, streamlining initial development.
Zone and Domain Management: Empowers users to manage zones and domains efficiently, including creation, deletion, and checking activation statuses.

This MCP Server enhances interaction with Cloudflare services by integrating natural language capabilities, making it accessible for both technical and non-technical users.

Cloudflare MCP Server

Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems. This repository provides an installer and an MCP Server for Cloudflare's API.

Getting Started

Setup

Initialize the MCP server:
```
npx @cloudflare/mcp-server-cloudflare init
```
Note: The MCP server will prompt for Cloudflare authentication if not already logged in.
Restart the application. A tool icon will appear showing the available tools for use.

Features

KV Store Management

get_kvs: List all KV namespaces.
kv_get: Retrieve a value from a KV namespace.
kv_put: Store a value in a KV namespace.
kv_list: List keys in a KV namespace.
kv_delete: Delete a key from a KV namespace.

R2 Storage Management

r2_list_buckets: List R2 buckets.
r2_create_bucket: Create an R2 bucket.
r2_delete_bucket: Delete an R2 bucket.
r2_list_objects: List objects in an R2 bucket.
r2_get_object: Retrieve an object from an R2 bucket.
r2_put_object: Store an object in an R2 bucket.
r2_delete_object: Delete an object from an R2 bucket.

D1 Database Management

d1_list_databases: List all D1 databases.
d1_create_database: Create a new D1 database.
d1_delete_database: Delete a D1 database.
d1_query: Execute a SQL query against a D1 database.

Workers Management

worker_list: List all Workers.
worker_get: Retrieve a Worker's script.
worker_put: Create or update a Worker script.
worker_delete: Delete a Worker script.

Durable Objects

durable_objects_list: List Durable Objects namespaces.
durable_objects_create: Create a new Durable Objects namespace.
durable_objects_delete: Delete a Durable Objects namespace.
durable_objects_list_instances: List instances for a Durable Objects namespace.
durable_objects_get_instance: Get details about a Durable Objects instance.
durable_objects_delete_instance: Delete a specific instance.

Analytics

analytics_get: Retrieve analytics data for your domain.

Developing

To set up the project locally:

pnpm install
pnpm build:watch

Then run:

node dist/index.js init

Testing

To run all tests:

pnpm test

To run tests with coverage:

pnpm test:coverage

To run a specific test file:

pnpm test -- tests/tools/queues.test.ts

Usage

To run the server locally, execute:

node dist/index run <account-id>

If using an alternative MCP Client, use the tools/list command for available tools, and call them using tools/call.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

mcp-server-cloudflare