mcp

Cloudflare API MCP Server

Project Context

This is a Model Control Protocol (MCP) server. It is a cloudflare worker that exposes a set of tools to an LLM. We will build a lightweight wrapper for LLMs to interact with the Cloudflare API. The full Typescript API docs is at Cloudflare Typescript SDK.md, you can search this file for the API calls you need.

What is MCP?

MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

MCP Clients are protocol clients that maintain 1:1 connections with servers.

MCP Servers, such as this one, are lightweight programs that each expose specific capabilities through the standardized Model Context Protocol.

Format for Defining Tools

Each method in the MyWorker class automatically becomes an MCP tool that can be used by AI agents. The method signature and JSDoc comments define how the tool appears to the agent.

/**
 * List all Cloudflare zones for the account.
 * @return {Promise<any>} List of zones.
 */
async listZones() {
    const response = await listZones(this.env);
    return response;
}

For tools with parameters:

/**
 * Create a new DNS record.
 * @param zoneId {string} The ID of the zone to create the record in.
 * @param name {string} The name of the DNS record.
 * @param content {string} The content of the DNS record.
 * @param type {string} The type of DNS record (CNAME, A, TXT, or MX).
 * @return {Promise<any>} The created DNS record.
 */
async createDNSRecord(zoneId: string, name: string, content: string, type: string) {
    return await createDNSRecord(this.env, zoneId, name, content, type);
}

The JSDoc structure is critical:

• The first line becomes the tool's description
• Each @param defines a parameter with its type and description
• The @return specifies what the tool returns