cueapi

cueapi-mcp

モデルコンテキストプロトコルに対応した、CueAPI公式サーバーです。CueAPIは、AI エージェントシステム向けのオープンソースの調整レイヤーです。

MCP 対応のアシスタント（Claude Desktop、Cursor、Zed、その他の MCP ホスト）に、会話内からエージェントの作業をスケジュールし、実行履歴を取得し、証拠に基づく結果レポートで一連の流れを完結させる機能を提供します。

導入理由

エージェントの作業は1回の呼び出しでは終わりません。時間、ツール、環境、エージェント、人間をまたいで連携します。引き継ぎのたびに、気づかれないまま失敗する可能性があります。CueAPIは、外部 ID、結果 URL、成果物などの構造化された証拠を添えて、それぞれの引き継ぎを完結させます。この MCP サーバーを使えば、エージェントはその機能に直接アクセスできるため、自分のフォローアップ作業をスケジュールし、証拠を示して結果を報告できます。

インストール

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

設定（Claude Desktop）

Claude Desktopの設定（macOSの場合は~/Library/Application Support/Claude/claude_desktop_config.json）に、以下を追加します。

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

API キーはcueapi.aiで生成してください。セルフホストする場合は、CUEAPI_API_KEYとともにCUEAPI_BASE_URLを設定してください。

設定（Cursor / Zed / その他のホスト）

stdio サーバーに対応した MCP ホストであれば、どれでも実行できます。ホストでcueapi-mcpバイナリを指定し、環境変数としてCUEAPI_API_KEYを渡してください。

公開されるツール

ツール	機能
cueapi_create_cue	繰り返し実行（cron）または1回限り（at）の cue を作成します
cueapi_list_cues	cue の一覧を取得し、ステータスで絞り込みます
cueapi_get_cue	単一の cue の詳細を取得します
cueapi_fire_cue	既存の cue をすぐに実行します。任意でペイロードを上書きできます
cueapi_update_cue	cue の変更可能なフィールド（名前、スケジュール、コールバック、ペイロードなど）を更新します
cueapi_pause_cue	cue を一時停止し、実行されないようにします
cueapi_resume_cue	一時停止中の cue を再開します
cueapi_delete_cue	cue を完全に削除します
cueapi_list_executions	実行履歴を取得し、cue またはステータスで絞り込みます
cueapi_get_execution	ID で単一の実行を取得します。状態と結果も含まれます
cueapi_list_claimable_executions	未取得のワーカー実行を一覧表示し、タスクまたはエージェントでサーバー側絞り込みを行います
cueapi_claim_execution	特定の実行を処理対象としてアトミックに取得します
cueapi_claim_next_execution	次に利用可能な実行を取得します（任意でタスクによる絞り込みが可能です）
cueapi_execution_heartbeat	実行中の実行に対する取得リースを延長します
cueapi_report_outcome	証拠（外部 ID / URL）を添えて、一度だけ結果を報告します

会話の例

あなた： Webhook にダイジェストを投稿する、毎日午前9時のジョブをスケジュールしてください。

アシスタント（cueapi_create_cueを使用）： cue cue_abc123を作成しました。初回実行は明日の9:00 UTCです。

あなた： 直近5回の実行結果を見せてください。

アシスタント（cueapi_list_executionsを使用）： ...

開発

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx

リンク

• CueAPI ホームページ： https://cueapi.ai
• ドキュメント： https://docs.cueapi.ai
• コア（オープンソース）： https://github.com/cueapi/cueapi-core
• モデルコンテキストプロトコル： https://modelcontextprotocol.io

変更履歴

• 0.4.1. cueapi_update_cue ツールを追加しました。キューの変更可能なフィールド（名前、スケジュール、コールバック URL、タイムゾーン、ペイロード、説明）を更新します。PATCH /v1/cues/{id} を呼び出します。スパース更新に対応しており、指定されたフィールドのみ送信します。ラッパー間の機能差を解消しました（これまで、他のすべてのクライアントラッパーには更新機能がありましたが、MCP にはありませんでした）。
• 0.4.0. 実行ライフサイクル関連のツールを5つ追加しました。cueapi_get_execution、cueapi_list_claimable_executions、cueapi_claim_execution、cueapi_claim_next_execution、cueapi_execution_heartbeat です。セッション内（例：Claude Desktop、Cursor、Zed）でワーカートランスポートの実行を利用したい MCP ホストエージェント向けに、受信からクレーム、処理、完了までの一連の流れをサポートします。主な点：list_claimable_executions は task／agent クエリパラメーターを使ってサーバー側でフィルタリングします（クライアント側のフィルタリングでは、既知の LIMIT-50 による枯渇問題が発生します）。claim_next_execution は任意の task_name を受け付けます。サーバーがまだ claim エンドポイント単体でのタスクフィルターに対応していないため、内部で（フィルタリング済みリストを取得 → 最も古いものを選択 → ID でクレーム）という処理を行います。execution_heartbeat は worker_id をリクエストヘッダー X-Worker-Id で送信します（サーバーがこのフィールドを受け取るための方法です）。スキーマでこの値を必須にすることで、設定ミスのある呼び出し元が競合防止を無言で回避するのではなく、ラッパー側で失敗するようにしています。内部変更：CueAPIClient.request() に任意の extraHeaders パラメーターを追加し、呼び出しごとのカスタムヘッダーをサポートします。
• 0.3.0. cueapi_fire_cue ツールを追加しました。既存のキューを、任意の payload_override と merge_strategy: 'merge' | 'replace'（デフォルトは 'merge'）を指定して即時実行します。POST /v1/cues/{id}/fire を呼び出します。一時的なキューを作成せずに、エージェントが臨時の単発実行を起動できるようにします。また、実行ごとの動的データを、保存済みのキューを変更することなく、Webhook のディスパッチとワーカーのクレーム応答に渡せます。
• 0.1.4. cueapi_pause_cue／cueapi_resume_cue が、{"status": "paused" | "active"} を使って PATCH /v1/cues/{id} を呼び出すよう修正しました（以前は存在しない /pause と /resume エンドポイントを呼び出し、実行時に404を返していました）。PR #1。この修正が実際に含まれているリリースです。0.1.3 ではこの注記とともに誤って先行公開されましたが、マージ済みのコードは含まれていませんでした。
• 0.1.3. 先行公開され、0.1.4 に置き換えられました。0.1.2 から機能上の変更はありません。
• 0.1.2. 公式 MCP レジストリに登録しました。
• 0.1.0. 初回リリース：キューの作成／一覧表示／取得／一時停止／再開／削除、実行一覧表示、結果報告のための8つのツール。

ライセンス

MIT © Vector Apps Inc.