damonzucconi-mcp

Удалённый MCP-сервер для управления damonzucconi.com через его GraphQL API.

Продакшн-эндпоинт: https://damonzucconi-mcp.damonzucconi.workers.dev/mcp

Сервер — это один не имеющий состояния Cloudflare Worker без привязок к хранилищу. Статический bearer-токен защищает MCP-эндпоинт. Worker входит в GraphQL API с существующими учётными данными администратора и кэширует полученный JWT до момента, близкого к истечению срока действия.

Он предоставляет инструменты для произведений, выставок, тегов, вложенных сущностей и упорядочивания. Удаление произведений и выставок намеренно недоступно; выполняйте его вручную.

Локальная разработка

Требуется Node.js 20+ и npm.

npm install
cp .dev.vars.example .dev.vars

Задайте три секрета в .dev.vars:

openssl rand -hex 32

MCP_AUTH_TOKEN=<paste-generated-value>
ADMIN_USERNAME=your-api-admin-username
ADMIN_PASSWORD=your-api-admin-password

MCP_AUTH_TOKEN — это общий секрет, а не имя пользователя или токен входа. Worker хранит одну копию, и каждый MCP-клиент отправляет то же значение в качестве bearer-токена. Обладание этим значением даёт доступ к серверу.

Автоматической синхронизации нет:

• .dev.vars предоставляет локальному Worker и является источником, используемым npm run secrets:push.

• npm run secrets:push копирует значение в зашифрованные секреты Cloudflare Worker для продакшена.

• Cursor и ChatGPT читают то же значение из клиентской переменной окружения DAMONZUCCONI_MCP_TOKEN.

Если вы меняете MCP_AUTH_TOKEN, выполните npm run secrets:push, обновите DAMONZUCCONI_MCP_TOKEN и перезапустите клиент. Клиент, использующий другое значение, получит 401 Unauthorized.

npm run codegen
npm run typecheck
npm run dev

Локальный MCP-эндпоинт: http://127.0.0.1:8787/mcp. В другом терминале:

npm run smoke

Чтобы вместо этого протестировать продакшен:

MCP_URL=https://damonzucconi-mcp.damonzucconi.workers.dev npm run smoke

Подключение из Cursor

Добавьте это в .cursor/mcp.json для этого проекта или в ~/.cursor/mcp.json глобально:

{
  "mcpServers": {
    "damonzucconi": {
      "url": "https://damonzucconi-mcp.damonzucconi.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DAMONZUCCONI_MCP_TOKEN}"
      }
    }
  }
}

Установите DAMONZUCCONI_MCP_TOKEN в окружении, которое наследует Cursor, используя то же значение, что и MCP_AUTH_TOKEN в .dev.vars, затем перезапустите Cursor. Удалённые серверы не поддерживают envFile.

Подключение из настольного ChatGPT

Настольное приложение ChatGPT использует общую конфигурацию MCP с Codex в ~/.codex/config.toml. Добавьте:

[mcp_servers.damonzucconi]
url = "https://damonzucconi-mcp.damonzucconi.workers.dev/mcp"
bearer_token_env_var = "DAMONZUCCONI_MCP_TOKEN"
default_tools_approval_mode = "writes"

В macOS сделайте токен доступным для приложений, запускаемых из Finder или Dock:

read -s "DAMONZUCCONI_MCP_TOKEN?MCP token: "
echo
launchctl setenv DAMONZUCCONI_MCP_TOKEN "$DAMONZUCCONI_MCP_TOKEN"
unset DAMONZUCCONI_MCP_TOKEN

Вставьте то же значение, что и MCP_AUTH_TOKEN, когда read запросит его. Токен не записывается в config.toml или историю командной оболочки.

Полностью закройте и снова откройте ChatGPT, затем откройте Настройки → MCP-серверы и выберите Перезапустить. Введите /mcp в композере, чтобы подтвердить, что damonzucconi подключён. См. документацию MCP от OpenAI, если изменится интерфейс настольного приложения.

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

Аутентификация Wrangler открывает браузер:

npx wrangler login

Для первого развёртывания:

npm run deploy
npm run secrets:push

secrets:push загружает три записи из .dev.vars. При последующих развёртываниях запускайте только npm run deploy, если секрет не изменился.

Перед развёртыванием изменений:

npm run codegen
npm run typecheck
npm run smoke
npm run deploy
MCP_URL=https://damonzucconi-mcp.damonzucconi.workers.dev npm run smoke

Генерация кода GraphQL

Запросы и мутации находятся в src/graphql/. npm run codegen выполняет интроспекцию живого API и обновляет:

• schema.graphql

• src/generated/

Не редактируйте сгенерированные файлы. Если после изменения API codegen или проверка типов завершаются с ошибкой, обновите операции .graphql или их схемы инструментов Zod перед развёртыванием.