Skip to content

Commit dac8cde

Browse files
axpnetaeroftp[bot]claude
committed
docs: align MCP/CLI/integration counts to aeroftp-cli v3.8.1
Rebuild the MCP Server tool tables against the real v3.8.1 surface: remove tools no longer exposed (server_info, file_versions, server_copy, create_share_link), rename head_file/tail_file to head/tail and checksum to hashsum, add debug_snapshot, debug_run_test, benchmark and server_exec, and sync the rate-limit table to match. Standardize the integration tiers everywhere on 7 transport protocols + 20+ native provider integrations + 40+ pre-configured presets: index.md (was 25+/45+) and protocols/overview.md (was 22+) now match mcp/overview.md and the CLI docs. The "39 curated tools" headline is confirmed by aeroftp-cli agent-info. Co-authored-by: aeroftp[bot] <aeroftp[bot]@users.noreply.github.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent fcaf46e commit dac8cde

3 files changed

Lines changed: 17 additions & 17 deletions

File tree

index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ features:
1919
src: /icons/protocols.svg
2020
alt: Protocols
2121
title: Multi-Protocol
22-
details: 7 transport protocols + 25+ native provider integrations + 45+ pre-configured presets - all native, no shellouts.
22+
details: 7 transport protocols + 20+ native provider integrations + 40+ pre-configured presets - all native, no shellouts.
2323
- icon:
2424
src: /icons/agent.svg
2525
alt: AeroAgent
@@ -58,7 +58,7 @@ import SnapTerritories from './.vitepress/theme/components/SnapTerritories.vue'
5858
<p align="center">AeroFTP organizes integrations on three tiers, so the catalog is precise rather than vague:</p>
5959

6060
<p align="center">
61-
<strong>7 transport protocols</strong> &middot; <strong>25+ native provider integrations</strong> &middot; <strong>45+ pre-configured presets</strong>
61+
<strong>7 transport protocols</strong> &middot; <strong>20+ native provider integrations</strong> &middot; <strong>40+ pre-configured presets</strong>
6262
</p>
6363

6464
<p align="center">

mcp/overview.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -70,23 +70,23 @@ The MCP server exposes the following curated tools (names use the `aeroftp_` pre
7070

7171
| Tool | Description |
7272
|------|-------------|
73-
| `list_servers` | List saved server profiles (names + protocol + tags + per-profile `auth_state` - never credentials). Supports a `filter` arg |
74-
| `mcp_info` | Server capabilities, version, supported protocols |
75-
| `server_info` | Connect to a profile and return server/protocol metadata |
73+
| `list_servers` | List saved server profiles from the encrypted vault (names + protocol + tags + per-profile `auth_state` - never credentials). Supports a `filter` arg |
74+
| `mcp_info` | Diagnostics about the running MCP process: version, supported protocols, capabilities |
7675
| `agent_connect` | Single-shot connect surface (added v3.6.6): one JSON envelope with `connect` + `capabilities` + `quota` + `path` blocks, replacing the boilerplate sequence `connect → about → df → ls /` |
77-
| `list_files` | List files and directories at a given path |
76+
| `list_files` | List files and directories at a given path. Pagination, sort, files-only / dirs-only filters |
7877
| `read_file` | Read text file content. `preview_kb` argument for soft-truncation (added v3.5.9) |
7978
| `file_info` | File or directory metadata (size, mtime, permissions, hash) |
80-
| `file_versions` | List historical versions where the protocol supports them |
81-
| `search_files` | Search files by name pattern (glob) |
79+
| `search_files` | Search files by name pattern (glob), with pagination and sort |
8280
| `storage_quota` | Storage quota (used/free/total) |
83-
| `checksum` / `hashsum` | Compute SHA-256 / SHA-1 / MD5 / BLAKE3 on a remote file (alias: `hashsum`, added v3.5.9) |
84-
| `head_file` / `tail_file` | First or last N lines of a remote text file (added v3.5.9) |
81+
| `hashsum` | Streamed SHA-256 / SHA-1 / MD5 / BLAKE3 of a remote file (alias: `checksum`, added v3.5.9) |
82+
| `head` / `tail` | First or last N lines of a remote UTF-8 text file, default 50, cap 10000 (added v3.5.9) |
8583
| `tree` | Recursive directory tree, depth-capped (added v3.5.9) |
8684
| `check_tree` | Categorized local-vs-remote diff. `compare_method` argument supports `size` / `mtime` / `checksum` (added v3.6.0). Per-group caps `max_match` / `max_differ` / `max_missing_local` / `max_missing_remote` and `omit_match` switch (added v3.7.0) |
8785
| `sync_doctor` | Preflight risk summary with `suggested_next_command`. Lighter than `sync_tree dry_run=true` (added v3.7.0) |
8886
| `reconcile` | Categorized size-only diff variant of `check_tree` with `elapsed_secs` and `suggested_next_command` (added v3.7.0) |
8987
| `dedupe` | SHA-256 duplicate detection grouped per size, modes `newest` / `oldest` / `largest` / `smallest` / `list`, dry-run by default (added v3.7.0) |
88+
| `debug_snapshot` | Static diagnostic snapshot: host / runtime info plus the last N redacted `aeroftp.log` lines |
89+
| `debug_run_test` | Run one self-contained diagnostic probe (e.g. `known_hosts`) and return its result |
9090

9191
### Medium Tools (Write Operations)
9292

@@ -97,31 +97,31 @@ The MCP server exposes the following curated tools (names use the `aeroftp_` pre
9797
| `upload_many` | Batch upload from a `files: []` array (mirrors CLI `--files-from`). Returns per-file `status` (uploaded / skipped / error). Added v3.5.10 |
9898
| `create_directory` | Create a remote directory |
9999
| `rename` | Rename or move a file or directory |
100-
| `server_copy` | Server-side copy (when supported by the protocol) |
101-
| `create_share_link` | Generate a share link with optional password/expiry |
102-
| `edit` | Find and replace in a remote text file (download → edit → upload). Added v3.5.10 |
100+
| `edit` | Find and replace in a remote text file without downloading it locally (added v3.5.10) |
103101
| `sync_tree` | Plan and execute a directory sync. Returns `plan[]` (per-file decision) and `plan_by_op` with caps; supports `dry_run` and pool-invalidate fix on apply |
104102
| `transfer` / `transfer_tree` | Cross-profile copy: single file or recursive directory between two saved profiles. Source and destination provider opened once and reused for the whole batch (added v3.7.0) |
105103
| `touch` | Create an empty file at a remote path, or report `action: "exists"` (added v3.7.0) |
106104
| `speed` | Throughput probe: random payload upload + download + SHA-256 integrity + cleanup. Caps 4 MiB default / 64 MiB max, iterations 1..3 (added v3.7.0) |
105+
| `benchmark` | Run the AeroFTP community benchmark suite against a saved profile and return the schema-v1 JSON report |
107106
| `close_connection` | Close the current pooled connection (forces reconnect on next call) |
108107

109108
### High Tools (Destructive)
110109

111110
| Tool | Description |
112111
|------|-------------|
113-
| `delete` | Permanently delete a remote file or directory |
112+
| `delete` | Permanently delete one or more remote entries (supports `recursive`) |
114113
| `delete_many` | Batch delete from an explicit list. Per-item `status` reporting |
115114
| `cleanup` | BFS scan for orphan `.aerotmp` partial-transfer files. Dry-run by default; deletes only when explicitly asked. Caps 100 k entries / depth 100 (added v3.7.0) |
115+
| `server_exec` | Execute a vault-backed server operation without exposing credentials to the model |
116116

117117
## Rate Limits
118118

119119
The MCP server enforces per-category rate limits to prevent runaway operations:
120120

121121
| Category | Limit | Tools |
122122
|----------|-------|-------|
123-
| **Read** | 60/min | list_servers, list_files, read_file, file_info, search_files, storage_quota, checksum, check_tree, server_info, mcp_info, file_versions |
124-
| **Write** | 30/min | upload_file, upload_many, download_file, create_directory, rename, server_copy, edit, sync_tree, create_share_link |
123+
| **Read** | 60/min | list_servers, list_files, read_file, file_info, search_files, storage_quota, hashsum, head, tail, tree, check_tree, reconcile, sync_doctor, dedupe, mcp_info, agent_connect |
124+
| **Write** | 30/min | upload_file, upload_many, download_file, create_directory, rename, edit, sync_tree, transfer, transfer_tree, touch, speed, benchmark |
125125
| **Delete** | 10/min | delete, delete_many |
126126

127127
When a rate limit is exceeded, the server returns an error with a `retry_after` hint.

protocols/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
AeroFTP organizes integrations on three tiers, so what you see in the catalog is precise rather than vague:
66

77
1. **7 transport protocols** - FTP, FTPS, SFTP, WebDAV, S3, Azure Blob, OpenStack Swift. Native wire-level support, implemented in Rust with full streaming.
8-
2. **22+ native provider integrations** - dedicated OAuth2 / API key / SDK code paths per provider (Google Drive, Dropbox, OneDrive, MEGA, Box, pCloud, Filen, Zoho WorkDrive, Internxt, kDrive, Koofr, Jottacloud, FileLu, Yandex Disk, OpenDrive, 4shared, Drime Cloud, Google Photos, GitHub, GitLab, Immich, ImageKit, Uploadcare). Each provider's specific features (sharing, native delta sync, server-side copy, large-file chunking) are first-class instead of best-effort.
8+
2. **20+ native provider integrations** - dedicated OAuth2 / API key / SDK code paths per provider (Google Drive, Dropbox, OneDrive, MEGA, Box, pCloud, Filen, Zoho WorkDrive, Internxt, kDrive, Koofr, Jottacloud, FileLu, Yandex Disk, OpenDrive, 4shared, Drime Cloud, Google Photos, GitHub, GitLab, Immich, ImageKit, Uploadcare). Each provider's specific features (sharing, native delta sync, server-side copy, large-file chunking) are first-class instead of best-effort.
99
3. **40+ pre-configured presets** - server URL, port, base path, password-generation deep-link auto-filled for compatible services on top of the protocols above. Visible in the Discover catalog (S3-compatible endpoints, WebDAV-compatible servers, SourceForge, etc.).
1010

1111
All credentials are encrypted in the AeroFTP Universal Vault (AES-256-GCM + Argon2id). Every integration plugs into AeroSync, AeroAgent, the CLI and the MCP server through the same `StorageProvider` trait.

0 commit comments

Comments
 (0)