Сервер протокола контекста модели (MCP) + Github OAuth

Это сервер протокола контекста модели (MCP), который поддерживает удаленные MCP-подключения со встроенной аутентификацией Github.

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

Вы можете использовать это как справочный пример того, как интегрировать другие OAuth-провайдеры с MCP-сервером, развернутым в Cloudflare, используя библиотеку workers-oauth-provider.

MCP-сервер (работающий на Cloudflare Workers):

• Выступает в роли OAuth-сервера для ваших MCP-клиентов

• Выступает в роли OAuth-клиента для вашего настоящего OAuth-сервера (в данном случае GitHub)

Начало работы

Клонируйте репозиторий напрямую и установите зависимости: npm install.

Альтернативно, вы можете использовать приведенную ниже командную строку, чтобы создать удаленный MCP-сервер на вашем локальном компьютере:

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-github-oauth

Для продакшена

Создайте новое приложение GitHub OAuth:

• В качестве URL домашней страницы укажите https://mcp-github-oauth.<your-subdomain>.workers.dev

• В качестве URL обратного вызова авторизации укажите https://mcp-github-oauth.<your-subdomain>.workers.dev/callback

• Запишите свой Client ID и создайте Client secret.

• Установите секреты через Wrangler

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY # add any random string here e.g. openssl rand -hex 32

Настройка пространства имен KV

• Создайте пространство имен KV: wrangler kv:namespace create "OAUTH_KV"

• Обновите файл Wrangler, указав ID KV

Развертывание и тестирование

Разверните MCP-сервер, чтобы сделать его доступным в вашем домене workers.dev wrangler deploy

Протестируйте удаленный сервер с помощью Inspector:

npx @modelcontextprotocol/inspector@latest

Введите https://mcp-github-oauth.<your-subdomain>.workers.dev/sse и нажмите «Connect». После прохождения процесса аутентификации вы увидите, что инструменты работают:

Теперь у вас развернут удаленный MCP-сервер!

Контроль доступа

Этот MCP-сервер использует GitHub OAuth для аутентификации. Все аутентифицированные пользователи GitHub могут получить доступ к базовым инструментам, таким как "add" и "userInfoOctokit".

Инструмент "generateImage" ограничен списком конкретных пользователей GitHub, указанных в конфигурации ALLOWED_USERNAMES:

// Add GitHub usernames for image generation access
const ALLOWED_USERNAMES = new Set([
  'yourusername',
  'teammate1'
]);

Доступ к удаленному MCP-серверу из Claude Desktop

Откройте Claude Desktop и перейдите в Settings -> Developer -> Edit Config. Это откроет файл конфигурации, который управляет тем, к каким MCP-серверам может обращаться Claude.

Замените содержимое следующей конфигурацией. После перезапуска Claude Desktop откроется окно браузера с вашей страницей входа OAuth. Завершите процесс аутентификации, чтобы предоставить Claude доступ к вашему MCP-серверу. После предоставления доступа инструменты станут доступны для использования.

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

Как только инструменты (под значком 🔨) появятся в интерфейсе, вы сможете попросить Claude использовать их. Например: "Could you use the math tool to add 23 and 19?". Claude должен вызвать инструмент и показать результат, сгенерированный MCP-сервером.

Для локальной разработки

Если вы хотите итерировать и тестировать свой MCP-сервер, вы можете делать это в локальной среде разработки. Для этого потребуется создать еще одно OAuth-приложение на GitHub:

• В качестве URL домашней страницы укажите http://localhost:8788

• В качестве URL обратного вызова авторизации укажите http://localhost:8788/callback

• Запишите свой Client ID и создайте Client secret.

• Создайте файл .dev.vars в корне проекта с содержимым:

GITHUB_CLIENT_ID=your_development_github_client_id
GITHUB_CLIENT_SECRET=your_development_github_client_secret

Разработка и тестирование

Запустите сервер локально, чтобы сделать его доступным по адресу http://localhost:8788 wrangler dev

Чтобы протестировать локальный сервер, введите http://localhost:8788/sse в Inspector и нажмите «Connect». После выполнения подсказок вы сможете выбрать "List Tools".

Использование Claude и других MCP-клиентов

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

Использование Cursor и других MCP-клиентов

Чтобы подключить Cursor к вашему MCP-серверу, выберите Type: "Command" и в поле Command объедините команду и аргументы в одну строку (например, npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse).

Обратите внимание, что хотя Cursor поддерживает серверы HTTP+SSE, он не поддерживает аутентификацию, поэтому вам все равно нужно использовать mcp-remote (и использовать STDIO-сервер, а не HTTP).

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

Related MCP server: GitHub MCP Server

Как это работает?

Лицензия

Этот проект лицензирован по лицензии GPL-3.0. Подробности см. в файле LICENSE.

OAuth-провайдер

Библиотека OAuth Provider служит полноценной реализацией сервера OAuth 2.1 для Cloudflare Workers. Она берет на себя сложности потока OAuth, включая выдачу, проверку и управление токенами. В этом проекте она выполняет двойную роль:

• Аутентификация MCP-клиентов, которые подключаются к вашему серверу

• Управление подключением к сервисам OAuth GitHub

• Безопасное хранение токенов и состояния аутентификации в хранилище KV

Durable MCP

Библиотека Durable MCP расширяет базовую функциональность MCP с помощью Durable Objects от Cloudflare, обеспечивая:

• Управление постоянным состоянием для вашего MCP-сервера

• Безопасное хранение контекста аутентификации между запросами

• Доступ к информации об аутентифицированном пользователе через this.props

• Поддержку условной доступности инструментов на основе личности пользователя

MCP Remote

Библиотека MCP Remote позволяет вашему серверу предоставлять инструменты, которые могут быть вызваны MCP-клиентами, такими как Inspector. Она:

• Определяет протокол для связи между клиентами и вашим сервером

• Предоставляет структурированный способ определения инструментов

• Обрабатывает сериализацию и десериализацию запросов и ответов

• Поддерживает соединение Server-Sent Events (SSE) между клиентами и вашим сервером