https://github.com/cloudflare/mcp-server-cloudflare
https://github.com/cloudflare/mcp-server-cloudflare
Last synced: 3 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/cloudflare/mcp-server-cloudflare
- Owner: cloudflare
- License: apache-2.0
- Created: 2024-11-27T22:07:30.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-20T09:00:58.000Z (27 days ago)
- Last Synced: 2025-04-07T04:01:33.648Z (10 days ago)
- Language: TypeScript
- Size: 334 KB
- Stars: 1,215
- Watchers: 21
- Forks: 83
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Cloudflare - Manage and interact with Cloudflare developer resources including Workers, KV, R2, and D1 (🏢 Enterprise-Supported Implementations / Developer Tools)
- awesome-mcp-servers - Cloudflare - Manage and interact with Cloudflare developer resources including Workers, KV, R2, and D1 (🏢 Enterprise-Supported Implementations / Developer Tools)
- awesome-mcp-servers - Cloudflare - Integration with Cloudflare services including Workers, KV, R2, and D1 (⚡ <a name="cloud-platforms"></a>Cloud Platforms)
- awesome-mcp-servers - Cloudflare - Integration with Cloudflare services including Workers, KV, R2, and D1 (⚡ <a name="cloud-platforms"></a>Cloud Platforms)
- awesome-mcp - Cloudflare - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1). (Servers / Typescript)
- awesome-mcp-list - cloudflare/mcp-server-cloudflare - server-cloudflare?style=social)](https://github.com/cloudflare/mcp-server-cloudflare): Integrates with various Cloudflare services like Workers and KV. (Uncategorized / Uncategorized)
- awesome-mcp - Cloudflare - <img src="./images/languages/typescript.svg" > Deploy and manage resources on the Cloudflare developer platform (Mcp Servers / integration)
- awesome-mcp - Cloudflare - <img src="./images/languages/typescript.svg" > Deploy and manage resources on the Cloudflare developer platform (Mcp Servers / integration)
- awesome-mcp-servers - Cloudflare MCP Server - Integration with Cloudflare services including Workers, KV, R2, and D1 (Legend / ☁️ <a name="cloud-platforms"></a>Cloud Platforms)
- awesome-mcp-servers - Cloudflare MCP Server - Integration with Cloudflare services including Workers, KV, R2, and D1 (Legend / ☁️ <a name="cloud-platforms"></a>Cloud Platforms)
- awesome-mcp-servers - Cloudflare - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1) (Official Servers)
- Awesome-MCP-Servers-directory - Cloudflare - Interacting with Cloudflare services (Cloud Platforms)
- awesome-mcp-servers - Cloudflare MCP Server - Workers、KV、R2、D1を含むCloudflareサービスとの統合 (サーバー実装 / ☁️ <a name="cloud-platforms"></a>クラウドプラットフォーム)
- awesome-mcp-servers - Cloudflare MCP Server - Manages Cloudflare services (Workers, KV, R2, D1) via natural language commands using the Model Context Protocol (Table of Contents / Cloud Platforms)
- awesome-mcp-servers - Cloudflare MCP Server - Manages Cloudflare services (Workers, KV, R2, D1) via natural language commands using the Model Context Protocol (Table of Contents / Cloud Platforms)
- awesome-mcp-servers - Cloudflare - Deploy, configure & interrogate your resources on the Cloudflare developer platform (e.g. Workers/KV/R2/D1) (Official Servers)
- awesome-mcp-zh - Cloudflare
- awesome-mcp-zh - cloudflare/mcp-server-cloudflare
README
# Cloudflare MCP Server Monorepo
Model Context Protocol (MCP) is a [new, standardized protocol](https://modelcontextprotocol.io/introduction) for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for [Cloudflare's API](https://api.cloudflare.com).
This lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things on your Cloudflare account, e.g.:
* `Please deploy me a new Worker with an example durable object.`
* `Can you tell me about the data in my D1 database named '...'?`
* `Can you copy all the entries from my KV namespace '...' into my R2 bucket '...'?`
## Access the remote MCP server from Claude Desktop
Open Claude Desktop and navigate to Settings -> Developer -> Edit Config. This opens the configuration file that controls which MCP servers Claude can access.
Replace the content with the following configuration. Once you restart Claude Desktop, a browser window will open showing your OAuth login page. Complete the authentication flow to grant Claude access to your MCP server. After you grant access, the tools will become available for you to use.
```
{
"mcpServers": {
"cloudflare": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.cloudflare.com/workers/observability/sse"
]
}
}
}
```
## Paid Features
Some features in this MCP server require a paid Cloudflare Workers plan:
- **Observability**: The prefixed `worker_logs_` tools require a paid Workers plan to access these metrics
Ensure your Cloudflare account has the necessary subscription level for the features you intend to use.
## Features
### Workers Management
- `worker_list`: List all Workers in your account
- `worker_get_worker`: Get a Worker's script content
### Workers Logs
- `worker_logs_by_worker_name`: Analyze recent logs for a Cloudflare Worker by worker name
- `worker_logs_by_ray_id`: Analyze recent logs across all workers for a specific request by Cloudflare Ray ID
- `worker_logs_keys`: Get available telemetry keys for a Cloudflare Worker
## Developing
### Apps
- [workers-observability](apps/workers-observability/): The Workers Observability MCP server
### Packages
- eslint-config: Eslint config used by all apps and packages.
- typescript-config: tsconfig used by all apps and packages.
- mcp-common: Shared common tools and scripts to help manage this repo.
For more details on development in this monorepo, take a look at apps/workers-observability
## Testing
The project uses Vitest as the testing framework with MSW (Mock Service Worker) for API mocking.
### Running Tests
To run all tests:
```bash
pnpm test
```
To run a specific test file:
```bash
pnpm test -- tests/tools/queues.test.ts
```
To run tests in watch mode (useful during development):
```bash
pnpm test:watch
```
## Looking for the deprecated local only cloudflare-mcp-server?
Visit
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.