formchime

formchime

formchime は、ウェブサイトのお問い合わせフォームを管理する Formgong のホスト型 MCP サーバーへの小規模なローカルブリッジです。 フォームを作成し、用意された埋め込みコードをページに貼り付けて、 届いた送信内容を読み取り、 新しい送信内容を署名付き JSON として自身のエンドポイントにも送信するよう Webhook を設定できます。

このブリッジは、独自のワークスペースを保持しません。稼働中のエンドポイントから取得した 上流サーバーのツール一覧を、そのままローカルで提供し、 各ツール呼び出しを上流に転送して、結果を変更せずに返します。フォームと Webhook の変更は呼び出し元自身の Formgong ワークスペースに対して行われます。一覧表示ツールと送信内容のツールは読み取り専用です。

ツール

• list_forms — アカウントが所有するすべてのフォーム：ID、 名前、公開アクセスキー（fk_…）、今月の送信件数。アクセスキーはフォームの非表示の access_key フィールドに設定します。引数はありません。
• create_form — 新しいフォームを作成します。必須：name （ダッシュボードとメールの件名に表示されます。1～80 文字）。任意：notify_email（デフォルトは true）。 フォーム ID と公開アクセスキーを返します。
• get_form_snippet — 1 つの フォーム用の、すぐに貼り付けられるフォームコードです。アクセスキー、非表示の _lang フィールド、 botcheck ハニーポット、および有効な場合は Turnstile ウィジェットが含まれます。 必須：form_id。任意：framework（html、 react または next、デフォルトは html）と lang。
• list_recent_submissions — 1 つのフォームの 最新の送信内容：ID、時刻、送信された フィールドのみ。IP アドレスやブラウザーのデータは含まれません。必須： form_id。任意：limit（1～50、デフォルトは 10）と include_spam（デフォルトは false）。
• list_webhooks — 1 つのフォームの Webhook URL：ID、 URL、作成日時。必須：form_id。
• create_webhook — 1 つのフォームに公開 HTTPS URL を追加します。 新しい送信内容はすべて、X-Signature ヘッダー付きの JSON として その URL に POST されます（フォームの署名キーを鍵とする生の本文の HMAC-SHA256）。 必須：form_id と url。Webhook ID と署名キーを返します。
• delete_webhook — フォームから 1 つの Webhook を削除します。 送信内容はその URL に送信されなくなります。必須： form_id と webhook_id。
• list_website_templates — Formgong の無料の MIT ライセンスのウェブサイトテンプレートです。各テンプレートには、お問い合わせフォームまたは 見積もりフォームがあらかじめ Formgong に接続されています。任意： topic（trades、consulting、portfolio、 construction、health、food または shops）。

設定

• FORMGONG_MCP_URL（任意）— 上流 エンドポイントを上書きします。デフォルトは https://formgong.com/mcp です。 （この上書き用フックは、この再構築で独自に追加したものとして明記されています。）
• FORMGONG_API_KEY（任意）— 設定すると、すべての 上流リクエストに Authorization: Bearer <key> ヘッダーが付与されます。これは OAuth ではなく個人用 API トークンを使用する クライアント向けです。設定されていない場合、認証ヘッダーは送信されません。元の インターフェイスはキーなしで取得されています。（この転送機能も、 この再構築で独自に追加したものとして明記されています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo name formchime）を送信し、続いて notifications/initialized 通知、さらに呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、 その値はセッション内の以降のすべてのリクエストに付与され、 プロセスの稼働中は同じセッションが再利用されます。応答は 通常の JSON またはサーバー送信イベントとして届く場合があります。 どちらも読み取ります。

上流の正常な結果は、上流が設定した isError フラグも含めて、 そのまま渡されます。失敗（JSON-RPC エラー、2xx 以外のステータス、 読み取れない応答、または完了できないリクエスト）は、 テキストが formchime error: で始まる isError 結果として返されます （この形式での返却は、この再構築で独自に追加したものとして明記されています）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても実行できます （引数を取らないツールでは省略します）。

npx @reneturcios/formchime list_forms
npx @reneturcios/formchime create_form '{"name":"Contact – acme.com"}'
npx @reneturcios/formchime get_form_snippet '{"form_id":"f_123","framework":"react"}'
npx @reneturcios/formchime list_recent_submissions '{"form_id":"f_123","limit":5}'
npx @reneturcios/formchime create_webhook '{"form_id":"f_123","url":"https://example.com/hook"}'
npx @reneturcios/formchime --version

終了コード：成功時は 0、isError の結果の場合は 1、 使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/formchime mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "formchime": {
      "command": "npx",
      "args": ["-y", "@reneturcios/formchime", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/formchime
docker run --rm ghcr.io/cloudcorprecords/formchime --version

コンテナーのデフォルトコマンドは mcp です。そのため、最初の 形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームを使用して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。