damonzucconi-mcp

damonzucconi.com をその GraphQL API を通じて管理するためのリモートMCPサーバー。

本番エンドポイント: https://damonzucconi-mcp.damonzucconi.workers.dev/mcp

このサーバーは、ストレージバインディングを持たない単一のステートレスなCloudflare Workerです。静的ベアラートークンがMCPエンドポイントを保護します。Workerは既存の管理者資格情報でGraphQL APIにサインインし、結果のJWTを有効期限の少し前までキャッシュします。

アートワーク、展示、タグ、ネストされたエンティティ、順序付けのためのツールを公開します。アートワークと展示の削除は意図的に利用できません。それらは手動で行ってください。

ローカル開発

Node.js 20+ と npm が必要です。

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

.dev.vars に3つのシークレットを設定します:

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は1つのコピーを保存し、各MCPクライアントは同じ値をベアラートークンとして送信します。この値の保持はサーバーへのアクセスを許可します。

自動同期はありません:

• .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}"
      }
    }
  }
}

Cursorが継承する環境に DAMONZUCCONI_MCP_TOKEN を設定し、.dev.vars の MCP_AUTH_TOKEN と同じ値を使用してから、Cursorを再起動します。リモートサーバーは envFile をサポートしていません。

ChatGPTデスクトップから接続

ChatGPTデスクトップアプリはCodexとMCP設定を ~/.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

read のプロンプトが表示されたら、MCP_AUTH_TOKEN と同じ値を貼り付けます。トークンは config.toml やシェル履歴には書き込まれません。

ChatGPTを完全に終了して再度開き、設定 → MCPサーバー を開いて 再起動 を選択します。コンポーザーに /mcp と入力して、damonzucconi が接続されていることを確認します。デスクトップUIが変更された場合は、OpenAIの MCPドキュメント を参照してください。

デプロイ

Wrangler認証はブラウザを開きます:

npx wrangler login

初回デプロイの場合:

npm run deploy
npm run secrets:push

secrets:push は .dev.vars から3つのエントリをアップロードします。以降のデプロイでは、シークレットが変更されない限り 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ツールスキーマを更新してください。