Этот шаблон является удалёным сервером Model Context Protocol (MCP). Он работает на Bun и на Cloudflare Workers. Использует официальный SDK MCP TypeScript.

Сервер использует версию протокола 2026-07-28. Он также принимает клиенты, использующие версии протокола 2025 года.

Шаблон включает следующие функции:

• Проверки заголовков Host и Origin.
• Проверка токена OAuth. Сервер является сервером ресурсов OAuth. Ваш код не получает токен.
• Политика ошибок. Сервер не отправляет внутренние данные об ошибках клиентам.
• Тесты, которые запускаются на Bun и на работниках Cloudflare.

Примерный сервер предоставляет погодные данные из Open-Meteo. Open-Meteo не требует API-ключа. Замените образцы своими инструментами. Оставьте остальные части шаблона.

Требования

• Булочка 1.4 или позже.
• Node.js 22:18 или позже. Команды Wrangler и дымовые тесты используют Node.js.

Запусти сервер

1. Установите зависимости:

2. Запустить сервер:

URL сервера — http://127.0.0.1:3000/mcp.

Чтобы использовать локальное время выполнения Cloudflare, запустите bun run dev:worker. Тогда URL сервера — http://127.0.0.1:8787/mcp.

Соедините клиента

Используйте URL сервера и потоковый HTTP-транспорт.

MCP Server Template

This template is a remote Model Context Protocol (MCP) server. It runs on Bun and on Cloudflare Workers. It uses the official MCP TypeScript SDK.

The server uses protocol version 2026-07-28. It also accepts clients that use the 2025 protocol versions.

The template includes these functions:

• Checks of the Host and Origin headers.
• OAuth token checks. The server is an OAuth resource server. Your code does not receive the token.
• An error policy. The server does not send internal error data to clients.
• Tests that run on Bun and on Cloudflare Workers.

The sample server gives weather data from Open-Meteo. Open-Meteo does not require an API key. Replace the samples with your tools. Keep the other parts of the template.

Requirements

• Bun 1.4 or later.
• Node.js 22.18 or later. The Wrangler commands and the smoke tests use Node.js.

Start the server

1. Install the dependencies:

   bun install
   

2. Start the server:

   bun run dev
   

The server URL is http://127.0.0.1:3000/mcp.

To use the Cloudflare local runtime, run bun run dev:worker. The server URL is then http://127.0.0.1:8787/mcp.

Connect a client

Use the server URL and the Streamable HTTP transport.

To test the connection, send a request. For example: “What is the weather in Kraków this week?”

Samples

Each sample shows one procedure.

Project structure

src/
  server.ts       Server identity, dependencies, token verification, extra routes, McpServer factory
  settings.ts     Settings for your code, for example API keys
  tools/          ┐