queueboard

queueboard

queueboard は、FeatureJet のホスト型 MCP サーバーへの小規模なローカルブリッジです。このサーバーでは、プロダクトチーム向けのフィードバックボードが運営されています。 利用者はボードにアイデアや要望を投稿し、投票やコメントを行います。チームは順位付けされたキューに取り組み、変更履歴を公開し、ボードの分析情報を確認します。

このブリッジは独自のフィードバックデータを保持しません。ライブエンドポイントから取得した上流サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。インターフェースの大部分では、呼び出し元自身のワークスペースに対して書き込みを行います。ボード、投稿、コメントを作成・編集でき、エージェントは作業キューから投稿を担当に設定し、証拠を添付して、所有者が確認するステータス変更を提案できます。

ツール

ボード：

• list_boards - 呼び出し元のキーからアクセスできるすべてのボードです。 引数はありません。
• get_board - slug で指定した1つのボードです。必須：slug。
• create_board - 下書きとして作成される新しいボードです。 必須：name、slug。任意：description。
• publish_board - ボードを公開 URL で公開します。 必須：slug。上流では既定で無効になっています。有効になっていない場合、所有者はダッシュボードから公開します。
• unpublish_board - ボードを下書きに戻し、公開 URL で表示されないようにします。必須：slug。

投稿、投票、コメント：

• list_posts - ボード上の投稿です。status、検索テキスト q、または tag で絞り込むことができ、limit と offset でページ分割できます。必須： slug。
• get_post - 1件の投稿の全情報です。必須：slug、 post_id。
• create_post - ボード上の新しい投稿です。必須： slug、title。任意：body、status、tags。
• update_post - title、body、status、tags、pinned、queue_rank など、変更可能な投稿フィールドを更新します（順位を null にすると、投稿の順位付けが解除されます）。 必須：slug、post_id。
• delete_post - 開発者 API を通じて投稿を非表示にします。 必須：slug、post_id。
• list_votes - 投稿の投票メタデータです。必須： slug、post_id。
• list_comments - 投稿へのコメントです。必須： slug、post_id。
• create_comment - ボードチームとしてコメントします。parent_comment_id を指定すると返信できます。必須： slug、post_id、body。

エージェントの作業キュー：

• get_queue - 所有者が設定した優先順で、未担当の上位投稿を取得します。順位付きの投稿が先に並び、その後に投票数順で順位未設定の予定投稿が続きます。必須：slug。任意： limit。
• claim_post - 作業に取り掛かる前に投稿をアトミックに担当設定することで、複数のエージェントが同じものを作成しないようにします。 必須：slug、post_id。任意：ttl_seconds （既定値 3600、最大値 86400）と agent_label。
• release_post - 担当を解除し、他のエージェントが投稿に取り組めるようにします。必須：slug、post_id。
• add_evidence - 投票者が投稿ページで確認できる実装の証拠を添付します。必須：slug、 post_id、kind（branch、commit、pr、 transcript、url のいずれか）、ref。任意：label、 action_key。
• propose_status - ボード所有者の確認を求めるステータス変更（open、planned、in_progress、shipped、declined のいずれか）を提案します。人が確認するまで、公開状態は何も変わりません。必須： slug、post_id、status。任意：note、 action_key。

読み取り：

• get_changelog - ボードのリリース済み投稿です。 必須：slug。
• get_analytics - ボードの読み取り専用分析情報です。period を指定して期間を絞り込めます。必須：slug。
• whoami - アクセス可能なボードを一覧表示して、呼び出し元のキーを確認します。引数はありません。
• ping - 呼び出し元のキーで MCP と FeatureJet API に到達できるか確認します。引数はありません。

設定

• FEATUREJET_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.featurejet.com/mcp です。（この上書きフックは、この再構築独自の明示的な再現です。）
• FEATUREJET_API_KEY（任意）— 設定すると、すべての上流リクエストに Authorization: Bearer <key> ヘッダーを付与します。設定されていない場合、認証ヘッダーは送信されません。（この転送も明示的な再現です。元のインターフェースはキーなしで取得されており、レジストリの記録では Authorization ヘッダーがキーの受け渡し手段として指定されています。）

転送の仕組み

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

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま返されます。JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、または完了できないリクエストなどの失敗は、テキストが queueboard error: で始まる isError 結果として返されます（この表示形式は、この再構築独自の明示的な再現です）。

CLI

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

npx @reneturcios/queueboard list_boards
npx @reneturcios/queueboard get_board '{"slug":"ideas"}'
npx @reneturcios/queueboard create_post '{"slug":"ideas","title":"Dark mode"}'
npx @reneturcios/queueboard get_queue '{"slug":"ideas"}'
npx @reneturcios/queueboard claim_post '{"slug":"ideas","post_id":42}'
npx @reneturcios/queueboard --version

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

MCP サーバー

npx -y @reneturcios/queueboard mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC 上流を使用して実行され、実際のネットワークリクエストは発生しません。

ライセンス

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