Быстрое развертывание служб MCP на рабочих станциях Cloudflare

Последние ресурсы по искусственному интеллектуОбновлено 6 месяцев назад Круг обмена ИИ

7.4K 00

Общее введение

Рабочие Cloudflare MCP это проект с открытым исходным кодом, разработанный Cloudflare и размещенный на GitHub, призванный помочь разработчикам быстро создавать и развертывать серверы MCP (Model Context Protocol) на базе Cloudflare Workers. Этот инструмент объединяет мощные возможности облачных вычислений Cloudflare Workers с протоколом MCP, позволяя пользователям создавать пользовательские инструменты с помощью простых функций TypeScript и интегрировать их в клиенты с поддержкой MCP, такие как Антропология (используется в форме номинального выражения) Клод Desktop). Он особенно подходит для разработчиков, которые хотят использовать инфраструктуру Cloudflare для достижения эффективных, легких серверных функций, поддерживающих такие сервисы, как R2, D1, KV и т. д. Процесс развертывания прост, а опыт разработки гладок, что очень популярно среди технического сообщества.

Список функций

Быстрая настройка сервера MCP: Быстрое порождение и развертывание серверов MCP на Cloudflare Workers с помощью инструмента CLI.
Поддержка разработки на TypeScript: Написание функциональных функций на TypeScript и создание описаний инструментов с помощью аннотаций JSDoc.
Интеграция сервисов Cloudflare: Поддерживает вызовы функций R2 (хранилище объектов), D1 (база данных), KV (хранилище ключей-значений) и других.
Бесшовное подключение к клиентам MCPВзаимодействие с клиентами MCP, такими как Claude Desktop, для настройки.
Автоматическое создание документов: Автоматическое создание дружественной к LLM документации по инструменту из комментариев JSDoc в коде.
Эффективный процесс развертывания: Развертывание в глобальной сети Cloudflare одним щелчком мыши в сочетании с Wrangler CLI.
Поддержка местного развития: Обеспечьте локальную тестовую среду для отладки и итераций.

Использование помощи

Процесс установки

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

1. Подготовка окружающей среды

Node.js: Убедитесь, что на вашем компьютере установлен Node.js (версия >= 16.17.0), что можно сделать с помощью команды node -v Проверьте версию.
Wrangler CLI: Это официальный инструмент командной строки для Cloudflare Workers для развертывания и управления проектами Worker. Способ установки:
```
npm install -g wrangler
```

После установки запустите wrangler login Войдите в свою учетную запись Cloudflare.

Рабочий стол Claude (опционально): Если вы хотите интегрировать MCP-сервер с Claude Desktop, вам необходимо загрузить и установить приложение Claude Desktop (официальный сайт: https://claude.ai/download).
Git: Чтобы клонировать проект с GitHub, выполните команду git --version Проверьте, установлен ли он.

2. Клонирование проектов

Откройте терминал и введите следующую команду, чтобы клонировать репозиторий Cloudflare Workers MCP:

git clone https://github.com/cloudflare/workers-mcp.git
cd workers-mcp

3. Установка зависимостей

Попав в каталог проекта, установите необходимые пакеты зависимостей. Вы можете выбрать либо npm, либо pnpm:

npm install

возможно

pnpm install

После завершения установки проект будет содержать все необходимые библиотеки, такие как @modelcontextprotocol/sdk ответить пением tsx.

4. Настройка Wrangler

Убедитесь, что ваш wrangler.toml Файл содержит информацию об учетной записи Cloudflare. Выполните следующую команду, чтобы войти в систему и создать файл конфигурации:

wrangler login

После успешного входа в систему отредактируйте wrangler.tomlДобавьте свой account_id(доступно на панели управления Cloudflare):

account_id = "你的账户ID"

5. локальные операции

Протестируйте сервер MCP локально, запустив его:

pnpm build
npx workers-mcp secret generate

Это генерирует ключ и сохраняет его в .dev.vars файл. Затем запустите локальную среду разработки:

wrangler dev

Локальный URL-адрес подсказки доступа (обычно http://localhost:8787), проверьте правильность работы сервера.

6. развертывание на Cloudflare

После проверки на наличие ошибок разверните Cloudflare Workers с помощью следующей команды:

pnpm deploy:worker

После успешного развертывания вы получите URL-адрес Cloudflare Worker (например. https://your-worker.workers.dev), это адрес вашего сервера MCP.

Функции Поток операций

Ключевые особенности: Быстрое создание серверов MCP

Написание функций TypeScript
показать (билет) src/index.tsв MyWorker класс для добавления пользовательских функций. Пример:
```
/**
* 返回一个友好的问候语。
* @param name {string} 用户的名字
* @return {string} 问候语内容
*/
sayHello(name: string) {
return `你好，${name}！来自 MCP Worker 的问候！`;
}
```
Аннотации JSDoc автоматически генерируют описания инструментов.
Создание документации
быть в движении pnpm buildИнструмент генерирует список всех файлов JSDoc, которые могут быть использованы в JSDoc. dist/docs.json, который содержит информацию об описании и параметрах всех инструментов.
функция тестирования
работать локально wrangler devЕсли вы хотите проверить его, вы можете сделать это с помощью браузера или curl-теста:
```
curl http://localhost:8787
```
В качестве альтернативы можно настроить адрес сервера MCP непосредственно в Claude Desktop, вызвав команду sayHello Инструменты.

Функция: Интеграция с Claude Desktop

Настройка рабочего стола Claude
Откройте файл конфигурации Claude Desktop claude_desktop_config.json(обычно находится в каталоге пользователя), добавьте сервер MCP:
```
{
"mcpServers": {
"my-worker": {
"command": "npx",
"args": ["workers-mcp", "proxy", "https://your-worker.workers.dev"]
}
}
}
```
Сохраните и перезапустите Claude Desktop.
инструмент вызова
В Claude Desktop наберите что-то вроде "Please call the sayHello utility to greet John", и вы увидите результат: "Hello John! Приветствую вас от MCP Worker!".

Функция: Интеграция с сервисами Cloudflare

Использование KV Storage
существовать wrangler.toml Добавьте привязку KV к

[[kv_namespaces]]
binding = "MY_KV"
id = "你的 KV ID"

Манипулируйте KV в коде:

async setValue(key: string, value: string) {
await this.env.MY_KV.put(key, value);
return `已存储 ${key}: ${value}`;
}

Развертывание и тестирование
После переразвертывания вызовите setValue инструмент для проверки того, что данные попали в KV.

предостережение

Управление ключами: Беги npx workers-mcp secret upload Загрузите свои ключи в Cloudflare, чтобы обеспечить безопасность.
Советы по отладке: Использование wrangler dev --remote Возможность подключения к привязкам производственной среды для облегчения отладки.
Расширенная функциональность: Дополнительные сервисы Cloudflare (например, R2, D1) можно ввести, просто добавив следующее в wrangler.toml Настройте привязку в

Выполнив эти шаги, вы сможете быстро приступить к работе с Cloudflare Workers MCP и создать мощный MCP-сервер!