El Protocolo de contexto de modelo (MCP) es un nuevo protocolo estandarizado para gestionar el contexto entre modelos de lenguaje grandes (LLM) y sistemas externos. En este repositorio, proporcionamos un instalador y un servidor MCP para la API de Cloudflare.
Esto le permite usar Claude Desktop, o cualquier cliente MCP, para usar lenguaje natural y lograr cosas en su cuenta de Cloudflare, por ejemplo:
Implemente un nuevo Worker con un objeto duradero de ejemplo.¿Puede informarme sobre los datos en mi base de datos D1 llamada '...'?¿Puede copiar todas las entradas de mi espacio de nombres KV '...' en mi depósito R2 '...'?
- Ejecuta
npx @cloudflare/mcp-server-cloudflare init - o clona localmente tu repo: "git clone https://github.com/avilaroman/MCP.git"
- Reinicia Claude Desktop. Deberías ver un pequeño ícono 🔨 que muestra las siguientes herramientas disponibles para usar:
get_kvs: enumera todos los espacios de nombres de KV en su cuentakv_get: obtiene un valor de un espacio de nombres de KVkv_put: almacena un valor en un espacio de nombres de KVkv_list: enumera las claves en un espacio de nombres de KVkv_delete: elimina una clave de un espacio de nombres de KV
r2_list_buckets: enumera todos los depósitos de R2 en su cuentar2_create_bucket: crea un nuevo depósito de R2r2_delete_bucket: eliminar un depósito R2r2_list_objects: enumerar objetos en un depósito R2r2_get_object: obtener un objeto de un depósito R2r2_put_object: colocar un objeto en un depósito R2r2_delete_object: eliminar un objeto de un depósito R2
d1_list_databases: enumerar todas las bases de datos D1 en su cuentad1_create_database: crear una nueva base de datos D1d1_delete_database: eliminar una base de datos D1d1_query: ejecutar una consulta SQL en una base de datos D1
worker_list: enumerar todos los Workers en su cuentaworker_get: obtener el contenido del script de un Workersworker_put: crear o actualizar un script de Workerworker_delete: eliminar un script de Worker
analytics_get: recuperar datos analíticos para su dominio- Incluye métricas como solicitudes, ancho de banda, amenazas y vistas de página
- Admite filtrado por rango de fechas
En la carpeta del proyecto actual,
git clone https://github.com/avilaroman/MCP.git
cd MCP
luego ejecute:
pnpm install
pnpm build:watch
Luego, en una segunda terminal:
node dist/index.js init
Esto vinculará Claude Desktop con su versión instalada localmente para que pueda probarla.
Para ejecutar el servidor localmente, ejecute node dist/index run <account-id>.
Si está usando un cliente MCP alternativo o está probando cosas localmente, emita el comando tools/list para obtener una lista actualizada de todas las herramientas disponibles. Luego, puede llamarlas directamente usando el comando tools/call.
// Listar Workers
worker_list()
// Obtener el código del Worker
worker_get({ name: "my-worker" })
// Actualizar 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"
}
],
compatible_date: "2024-01-01",
compatible_flags: ["nodejs_compat"]
})
// Eliminar Workers
worker_delete({ name: "my-worker" })// Lista de espacios de nombres de KV
get_kvs()
// Obtener valor
kv_get({
namespaceId: "your_namespace_id",
key: "myKey"
})
// Almacenar valor
kv_put({
namespaceId: "your_namespace_id",
key: "myKey",
value: "myValue",
expirationTtl: 3600 // opcional, en segundos
})
// Lista de claves
kv_list({
namespaceId: "your_namespace_id",
prefix: "app_", // opcional
limit: 10 // opcional
})
// Eliminar clave
kv_delete({
namespaceId: "your_namespace_id",
key: "myKey"
})// Lista de depósitos
r2_list_buckets()
// Crear depósito
r2_create_bucket({ name: "my-bucket" })
// Eliminar depósito
r2_delete_bucket({ name: "my-bucket" })
// Listar objetos en el depósito
r2_list_objects({
depósito: "my-bucket",
prefijo: "carpeta/", // opcional
delimitador: "/", // opcional
límite: 1000 // opcional
})
// Obtener objeto
r2_get_object({
depósito: "my-bucket",
clave: "carpeta/archivo.txt"
})
// Poner objeto
r2_put_object({