FileAgent

エージェント向けFTP: 共有仮想ファイルシステム。各ファイルはSHA-256でアドレス指定・検証され、アップロード時にメタデータが抽出されます。

同じFILEAGENT_DATA_DIR(stdio)または同じHTTPサーバー上のエージェントは、同じコレクションを参照します。登録されたハッシュなしでは、何も出入りできません(ftp_register)。このaccess_hashがチャネルであり、ファイルのSHA-256が完全性の証明です。

モデル

agente A                         FileAgent                       agente B
   |-- ftp_register() -----------> |                               |
   |<-- access_hash ---------------|                               |
   |---------------- compartilha access_hash --------------------->|
   |-- ftp_put(/inbox/a.md, hash) >|  sha256 + metadata            |
   |                               |<-- ftp_get(/inbox/a.md, hash)-|

ftp_registerで同じsecretを持つ2つのエージェントは、同じaccess_hashを取得します。

Related MCP server: MEFS MCP Server

FTPツール

doc_*は、パスにリンクされたドキュメントの共同編集(lock + doc_commit)に引き続き使用されます。

リソース: fileagent://fs、fileagent://docs、fileagent://blob/{hash}。

抽出されるメタデータ

ftp_put / ftp_stat / ftp_lsで:

• 常に: hash、size、mime、kind、filename、extension

• テキスト / markdown: タイトル、見出し、行数、単語数、言語(pt/en)

• JSON: 妥当性、型、キー

• CSV: 列と行数

• PNG / JPEG / GIF: 幅と高さ

• PDF: バージョン、ヘッダーに存在する場合はtitle/author

管理者とパスワード

access_hashを登録できるのは管理者のみです。平文のパスワードはプロジェクトの.venvにのみ保存されます(gitの外):

• ハッシュ: .venv/fileagent_admin.hash (PBKDF2-SHA256)

• パスワード: .venv/fileagent_admin.password

uv run fileagent --init-admin          # gera se ainda não existir
uv run fileagent --rotate-admin        # nova senha

ブラウザのパネル: /を開き、そのパスワードでログインすると、すべてのチャネルのすべてのファイルを表示できます。ログインしないと、リストは表示されません。

# cadastrar um canal para clientes
curl -sS -X POST http://127.0.0.1:8765/v1/admin/register \
  -H "Content-Type: application/json" \
  -d '{"admin_password":"<senha>","label":"equipe-a"}'

クライアントはハッシュを登録しません。POST /v1/filesまたはftp_putで返されたaccess_hashを使用します。

デプロイ

uv run fileagent --http --host 0.0.0.0 --port 8765

• 管理パネル(ログイン): http://<host>:8765/

• MCP: http://<host>:8765/mcp

• REST: POST/GET /v1/files、ヘッダーX-Access-Hash付き

• ヘルスチェック: GET /healthz

スキル

• fileagent-send — 送信するエージェント

• fileagent-receive — 一覧表示/ダウンロードするエージェント

インストール

cd /Users/naubergois/FileAgent
uv sync --extra dev

Cursor(エージェント間で同じストア)

{
  "mcpServers": {
    "fileagent": {
      "command": "uv",
      "args": ["--directory", "/Users/naubergois/FileAgent", "run", "fileagent"],
      "env": {
        "FILEAGENT_DATA_DIR": "/Users/naubergois/.fileagent",
        "FILEAGENT_AGENT_ID": "cursor",
        "FILEAGENT_OPEN_EDIT": "1"
      }
    }
  }
}

各エージェント: 同じFILEAGENT_DATA_DIR、異なるFILEAGENT_AGENT_ID。

HTTP

uv run fileagent --http --port 8765

変数

privateパスは所有者(およびgrant)のみが参照できます。agent_idは調整用であり、強力な認証ではありません。コンテンツのセキュリティはハッシュです: バイトが変更されると、読み取りは失敗します。

現在の本番環境(AWS): https://fileagent.54-204-243-102.sslip.io/ — 管理者パスワード付きパネル。

テスト

uv run pytest -q