Cloudflare MCP Server — Code Mode

Стартовый serverless-проект для создания удалённого сервера Model Context Protocol (MCP) на Cloudflare Workers.

Проект спроектирован для code mode: клиенты могут обнаруживать возможности и составлять вызовы инструментов на основе структурированных ответов. Произвольное выполнение кода не включено в стартер; его следует добавлять только после определения песочницы, аутентификации, лимитов и аудита.

Цели

• Выполняться на edge через Cloudflare Workers.

• Предоставлять эндпоинт MCP на /mcp.

• Держать инструменты небольшими, типизированными и компонуемыми.

• Подготовить OAuth-аутентификацию и Cloudflare bindings.

• Развиваться до безопасного выполнения кода в изолированной песочнице.

Related MCP server: remote-mcp-server-authless01

Локальная разработка

Предварительные требования: Node.js 18+ и учётная запись Cloudflare с включёнными Workers.

npm install
npm run dev

Локальный сервер доступен по адресу http://localhost:8788/mcp.

Для проверки с помощью MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Деплой

npx wrangler login
npm run deploy

После деплоя эндпоинт будет доступен по адресу:

https://<worker>.<account>.workers.dev/mcp

Структура

• src/index.ts: HTTP-маршрутизация Worker.

• src/mcp.ts: сервер MCP и инструменты.

• wrangler.jsonc: конфигурация Worker.

• PLAN.md: план реализации и критерии приёмки.

Безопасность

Не добавляйте eval, new Function или интерпретатор кода непосредственно в Worker. Для code mode с реальным выполнением используйте подходящую песочницу, строгую аутентификацию, списки разрешённых API, лимиты CPU/памяти/времени, изоляцию по пользователю и логи без секретов.

Следующие шаги

Смотрите PLAN.md.