purpose
github-webhook-mcp の正規形を、プラグインとして配布しやすいスタンドアロン構成として定義する。
premise
- 現在の優先事項は、共有運用よりもインストール性・配布性・痕跡の少なさである。
- 現在の正規像は、起動中のみ受信・処理するクライアント型サーバーである。
- 現行の仮称は
webhook event server とする。名前は暫定であり、後から変更可能。
events.json は既存のイベントストアとしてそのまま利用し、新しい DB や追加 state の導入は前提にしない。
- Claude と Codex の両方で使う可能性はあるが、初期方針として共有 inbox や共有 claim を成立条件にしない。
- webhook 受信と MCP 提供は、現時点では同一実体で兼任してよい。
- Windows を落としている間に webhook を完全受信しない現状は受け入れる。
- 将来的には別モードまたは別実装として、常駐型
webhook server を持つ余地を残す。
constraints
- issue は現時点の設計方針を固定する durable work memo とする。
- いまは実装着手より先に、スタンドアロン前提の背骨を揃える。
- 標準モードはスタンドアロンであり、共有運用は後から必要になった場合のみ検討する。
- 既存の
events.json を起点に考え、今ある構造を別の state や DB で置き換えない。
- 一体実装でもよいが、内部責務としては webhook intake / event store / MCP access の切り分けを保つ。
purpose
github-webhook-mcpの正規形を、プラグインとして配布しやすいスタンドアロン構成として定義する。premise
webhook event serverとする。名前は暫定であり、後から変更可能。events.jsonは既存のイベントストアとしてそのまま利用し、新しい DB や追加 state の導入は前提にしない。webhook serverを持つ余地を残す。constraints
events.jsonを起点に考え、今ある構造を別の state や DB で置き換えない。