Cashpilot Mcp

cashpilot-mcp

あらゆる CashPilot インスタンスを MCP サーバーとして公開する小さなブリッジです。LLM が不労所得の収益を監視し、サービスを管理し、フリートワーカーを制御できるようにします。

独自の CashPilot インスタンスに API キーで接続し、stdio または Streamable HTTP 経由で通信します。

同一のバイナリで MCP 2026-07-28 と、それ以前のすべてのリビジョン（2024-11-05 まで）に対応しています。initialize ハンドシェイクを引き続き使用する現在のクライアント（Claude Code、Claude Desktop、Cursor、VS Code）と、2026-07-28 クライアント（server/discover、ステートレスリクエスト）の両方が動作します。

機能

• 収益：合計、サービスごとの出金可能額、日別の推移と履歴。
• フリート：デプロイ済みサービス、デプロイ可能なカタログ、ワーカー、ヘルススコア、コレクターのアラートを、ツールおよび cashpilot:// リソースとして提供します。
• 任意のワーカーでサービスを制御：開始、停止、再起動、デプロイ、削除、ログのほか、trigger_collection とアーキテクチャごとの Docker Compose エクスポートに対応します。
• 読み取り専用モード：CASHPILOT_READ_ONLY=true を設定すると、変更を行わないツールだけを登録します。
• すべてのツールにタイトルと読み取り専用／破壊的操作のヒントが付いています。一覧を返すツールは構造化 JSON を返し、入力は検証されます。
• HTTP モードは 127.0.0.1:8081 で待ち受け、Origin を確認し、リクエストサイズを制限します。ループバック以外のアドレスでは MCP_AUTH_TOKEN が必須です。

インストール

各スニペットは npm パッケージを stdio 経由で実行します。フルコントロールには管理者キー（CASHPILOT_ADMIN_API_KEY）を、読み取り専用キー（CASHPILOT_READONLY_API_KEY）を使う場合は CASHPILOT_READ_ONLY=true を指定してください。フリートキーは絶対に使用しないでください。

Claude Code

claude mcp add --transport stdio --env CASHPILOT_URL=http://localhost:8080 --env CASHPILOT_API_KEY=<key> cashpilot -- npx -y cashpilot-mcp

Claude Desktop（claude_desktop_config.json）および Cursor（~/.cursor/mcp.json または .cursor/mcp.json）

{
  "mcpServers": {
    "cashpilot": {
      "command": "npx",
      "args": ["-y", "cashpilot-mcp"],
      "env": {
        "CASHPILOT_URL": "http://localhost:8080",
        "CASHPILOT_API_KEY": "<key>"
      }
    }
  }
}

VS Code（.vscode/mcp.json。キーは一度入力すると VS Code に保存されます）

{
  "inputs": [
    { "id": "cashpilot-key", "type": "promptString", "description": "CashPilot API key", "password": true }
  ],
  "servers": {
    "cashpilot": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "cashpilot-mcp"],
      "env": { "CASHPILOT_URL": "http://localhost:8080", "CASHPILOT_API_KEY": "${input:cashpilot-key}" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.cashpilot]
command = "npx"
args = ["-y", "cashpilot-mcp"]
env = { CASHPILOT_URL = "http://localhost:8080", CASHPILOT_API_KEY = "<key>" }

Docker、HTTP サーバー、ローカルビルドについてははじめにをご覧ください。すべての変数については設定をご覧ください。

ツール

ツール	機能	フリートに変更を加える
get_earnings_summary	合計額：今日、今月、全期間	いいえ
get_earnings_breakdown	サービスごとの残高と出金資格	いいえ
get_earnings_daily	1～365日分の日ごとの合計額	いいえ
get_earnings_history	週、月、年、または全期間の記録	いいえ
list_deployed_services	実行場所、ステータス、リソースを含む一覧	いいえ
list_available_services	必要な環境変数キーを含むデプロイ可能なカタログ	いいえ
get_fleet_summary	オンライン数と総数を含むワーカーとコンテナ	いいえ
list_workers	worker_id 用のワーカー ID	いいえ
get_health_scores	1～90日間のサービスごとのヘルススコア	いいえ
get_collector_alerts	前回の収益収集時に発生したエラー	いいえ
get_service_logs	コンテナの最新ログ行（信頼できないコンテンツ）	いいえ
get_compose	amd64、arm64、arm 用の docker-compose.yml	いいえ
trigger_collection	収益をバックグラウンドで今すぐ収集	はい
start_service / restart_service	コンテナを起動または再起動	はい
stop_service	コンテナを停止。収益の発生も停止します	はい、破壊的
deploy_service	環境変数、ホスト名、インスタンス数を指定してデプロイまたは再デプロイ	はい、破壊的
remove_service	デプロイを削除。ボリュームは保持されます	はい、破壊的

複数のワーカーがオンラインの場合、サービスツールには list_workers で取得した worker_id が必要です。リソースと詳細については、使い方をご覧ください。

ドキュメント

• はじめに：Docker Compose、npm、ローカルビルド
• 設定：環境変数と MCP クライアントの設定
• 使い方：リソースとツール
• 開発：テスト、貢献、クレジット
• 関連プロジェクト：関連プロジェクトとレジストリの掲載情報

関連プロジェクト

このサーバーが連携するパッシブインカム向けフリート管理ツール、CashPilotです。

ライセンス

GPL-3.0-or-later