Fleetpost

fleetpost-mcp

エージェントにフリートのメールボックスを与えます。 Fleetpost 用の MCP サーバーです。任意の rclone リモートを介して、オフラインに強く、サーバーレスでマシン間の連携を実現します。

エージェントは、ほかのマシンに何ができるかを確認し、そのうちの1台にタスクを依頼して、自分の受信トレイを処理できます。サーバーもデーモンも必要なく、すべてのマシンが同時にオンラインである必要もありません。オフラインのマシンは、次のサイクルでメールを取得します。

ツール

ツール	説明
fleet_status	未処理のリクエスト、プロトコルの変更、把握しているマシン、前回のサイクルなど、待機中の内容を確認します
fleet_capabilities	フリート内の各マシンができることを確認します
fleet_read_request	このマシンの受信トレイからリクエストを1件読み取ります
fleet_send_request	別のマシンに作業を依頼します。受信トレイにリクエストを置きます
fleet_handle	リクエストを完了としてマークし、inbox/handled/ に移動します
fleet_sync	連携サイクルを今すぐ1回実行します

リモートにアクセスするのは fleet_send_request と fleet_sync だけです。それ以外は、同期時にすでに取得されたファイルを読み取るため、ステータスをすぐに確認でき、ネットワーク接続がなくても機能します。

セットアップ

config.env を設定済みの Fleetpost のチェックアウトが必要です。詳しくは メインの README を参照してください。MCP サーバーは同じファイルを読み込むため、独自の設定は不要です。

{
  "mcpServers": {
    "fleetpost": {
      "command": "uvx",
      "args": ["fleetpost-mcp"],
      "env": {
        "FLEETPOST_CONFIG": "/path/to/fleetpost/config.env"
      }
    }
  }
}

サーバーを config.env があるディレクトリで起動する場合、FLEETPOST_CONFIG は省略できます。設定ファイルをチェックアウト先から別の場所にコピーした場合は、FLEETPOST_HOME にチェックアウト先も設定してください。fleet_sync と fleet_handle はリポジトリ独自のスクリプトを実行します。

その後、エージェントに次のように尋ねてください。

私に届いているものはありますか？ — ビルド用マシンが署名できるなら、リリースへの署名も依頼してください。

このツールが行わないこと

プロトコルのルールは、文書に記載するだけでなく、ここで適用されます。

• 書き込み先は、別のマシンの受信トレイのトップレベルのみです。 handled/ や、ほかのマシンの記述ファイルには書き込みません。これにより、同時書き込みの安全性が保たれます。
• fleet_handle が整理するのは、自分の受信トレイだけです。 受信トレイを整理できるのは、その所有者だけです。
• リクエストは、完全な内容でなければ送信できません。 何を求めるのか、「完了」の定義、有効期限は必須引数です。不正なリクエストは作成できません。
• アクセスではなく、作業を依頼してください。 必要な認証情報を持っていない場合は、それを持つマシンが作業を行い、結果を返します。シークレットが送信されることはありません。

独自のサーバー、データベース、デーモンはありません。転送には引き続き rclone リモート上のフォルダーを使用し、このサーバーはその中のファイルを読み書きするだけです。

ライセンス

MIT。