Удаленный сервер MCP на Cloudflare

Давайте запустим удаленный сервер MCP на Cloudflare Workers с возможностью входа по протоколу OAuth!

Развивайтесь локально

# clone the repository
git clone https://github.com/cloudflare/ai.git
# Or if using ssh:
# git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
# Note: using pnpm instead of just "npm"
pnpm install

# run locally
npx nx dev remote-mcp-server

Вы должны иметь возможность открыть http://localhost:8787/ в своем браузере.

Related MCP server: Remote MCP Server

Подключите MCP-инспектор к вашему серверу

Для изучения нового API MCP вы можете использовать MCP Inspector .

• Запустите его с помощью npx @modelcontextprotocol/inspector

• В инспекторе измените тип транспорта на SSE и введите http://localhost:8787/sse в качестве URL-адреса сервера MCP для подключения, затем нажмите «Подключиться».

• Вы перейдете на экран входа в систему (фиктивный) пользователя/пароля. Введите любой адрес электронной почты и пароль для входа.

• Вас перенаправят обратно в MCP Inspector, и теперь вы сможете просматривать и вызывать любые определенные инструменты!

Подключите Claude Desktop к локальному серверу MCP

Инспектор MCP великолепен, но мы действительно хотим подключить его к Claude! Следуйте краткому руководству Anthropic и в Claude Desktop перейдите в Настройки > Разработчик > Изменить конфигурацию, чтобы найти файл конфигурации.

Откройте файл в текстовом редакторе и замените его следующей конфигурацией:

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Это запустит локальный прокси-сервер и позволит Клоду взаимодействовать с вашим сервером MCP по протоколу HTTP.

Когда вы открываете Claude, должно открыться окно браузера, позволяющее вам войти в систему. Вы должны увидеть доступные инструменты в правом нижнем углу. Получив правильный запрос, Claude должен попросить вызвать инструмент.

Развертывание в Cloudflare

1. npx wrangler kv namespace create OAUTH_KV

2. Следуйте инструкциям, чтобы добавить идентификатор пространства имен kv в wrangler.jsonc

3. npm run deploy

Вызовите недавно развернутый удаленный сервер MCP с удаленного клиента MCP

Так же, как вы делали выше в разделе «Локальная разработка», запустите инспектор MCP:

npx @modelcontextprotocol/inspector@latest

Затем введите URL-адрес workers.dev (например: worker-name.account-name.workers.dev/sse ) вашего Worker в инспекторе в качестве URL-адреса сервера MCP для подключения и нажмите «Подключиться».

Теперь вы подключились к своему серверу MCP с удаленного клиента MCP.

Подключите Claude Desktop к удаленному серверу MCP

Обновите файл конфигурации Claude, чтобы он указывал на URL-адрес вашего workers.dev (например: worker-name.account-name.workers.dev/sse ), и перезапустите Claude.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://worker-name.account-name.workers.dev/sse"
      ]
    }
  }
}

Отладка

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

npx mcp-remote http://localhost:8787/sse

В некоторых редких случаях может помочь очистка файлов, добавленных в ~/.mcp-auth

rm -rf ~/.mcp-auth