Сервер Cloudflare MCP

Model Context Protocol (MCP) — это новый стандартизированный протокол для управления контекстом между большими языковыми моделями (LLM) и внешними системами. В этом репозитории вы найдете несколько MCP-серверов, которые позволяют подключиться к службам Cloudflare из MCP-клиента (например, Cursor, Claude) и использовать естественный язык для выполнения задач через ваш аккаунт Cloudflare.

Эти MCP-серверы позволяют вашему MCP-клиенту читать конфигурации из вашего аккаунта, обрабатывать информацию, делать предложения на основе данных и даже вносить эти предложенные изменения за вас. Все эти действия могут выполняться через множество служб Cloudflare, включая разработку приложений, безопасность и производительность.

Они поддерживают как транспорт streamable-http через /mcp, так и транспорт sse (устаревший) через /sse.

В этом репозитории включены следующие серверы:

Какой сервер Cloudflare MCP следует использовать?

Cloudflare предоставляет две категории MCP-серверов:

• Сервер режима кода (mcp.cloudflare.com) в cloudflare/mcp: наиболее удобен, когда вам нужен широкий доступ к API Cloudflare через выполнение кода.
• Специализированные серверы (*.mcp.cloudflare.com) в этом репозитории: наиболее удобны, когда вам нужны целенаправленные, типизированные инструменты для конкретной области продукта Cloudflare.

Когда следует использовать тот или иной?

Используйте сервер режима кода, когда:

• вам нужен широкий охват API для многих продуктов Cloudflare
• вы предпочитаете небольшой набор универсальных инструментов
• выполнение кода лучше подходит для вашего рабочего процесса

Используйте специализированные серверы в этом репозитории, когда:

• вам нужны специализированные инструменты для конкретной области продукта
• вы хотите более управляемые, типизированные взаимодействия
• вы работаете в основном в рамках одного домена Cloudflare, такого как наблюдаемость, привязки, Radar или рендеринг браузера

Узнайте больше о сервере режима кода здесь: cloudflare/mcp.

Подключение к удаленному MCP-серверу из любого MCP-клиента

Если ваш MCP-клиент имеет первоклассную поддержку удаленных MCP-серверов, клиент предоставит способ принять URL сервера непосредственно в своем интерфейсе (например, Cloudflare AI Playground).

Если ваш клиент еще не поддерживает удаленные MCP-серверы, вам необходимо настроить его соответствующий конфигурационный файл с помощью mcp-remote (https://www.npmjs.com/package/mcp-remote), чтобы указать, к каким серверам ваш клиент может получать доступ.

{
    "mcpServers": {
        "cloudflare-observability": {
            "command": "npx",
            "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/mcp"]
        },
        "cloudflare-bindings": {
            "command": "npx",
            "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/mcp"]
        }
    }
}

Использование MCP-серверов Cloudflare через OpenAI Responses API

Чтобы использовать один из MCP-серверов Cloudflare с API ответов OpenAI, вам необходимо предоставить API ответов маркер API, который имеет области (разрешения), требуемые для данного MCP-сервера.

Например, чтобы использовать MCP-сервер рендеринга браузера с OpenAI, создайте маркер API в панели управления Cloudflare здесь со следующими разрешениями:

Нужен доступ к дополнительным инструментам Cloudflare?

Мы продолжаем добавлять новые функции в этот репозиторий удаленных MCP-серверов. Если вы хотите оставить отзыв, сообщить об ошибке или запросить новую функцию, пожалуйста, создайте задачу в этом репозитории.

Устранение неполадок

«Ответ Claude был прерван ... »

Если вы видите это сообщение, значит, Claude, вероятно, достиг ограничения длины контекста и остановил ответ на середине. Это чаще всего происходит на серверах, которые инициируют множество последовательных вызовов инструментов, таких как сервер наблюдаемости.

Чтобы снизить вероятность столкновения с этой проблемой:

• Старайтесь формулировать запросы конкретно, делайте их краткими.
• Если один запрос вызывает несколько инструментов, попробуйте разделить его на несколько более мелких вызовов инструментов, чтобы ответы оставались короткими.

Платные функции

Некоторые функции могут потребовать платного тарифного плана Cloudflare Workers. Убедитесь, что ваш аккаунт Cloudflare имеет необходимый уровень подписки для функций, которые вы намерены использовать.

Участие в разработке

Хотите внести вклад и запустить этот сервер локально? Ознакомьтесь с CONTRIBUTING.md, чтобы начать.