AnyEvent-MCP
view release on metacpan or search on metacpan
extended eNN_ files skipped without PERL_ANYEVENT_MCP_TESTS=1;
add independent core filesystem smoke tests while retaining the full
integration and failure-injection suite for development and releases.
- include mailbox, destination, operation, batch size, paging position
and bounded SEARCH criteria in mcp-imap request logs, without
logging message bodies or UID lists.
- keep remote filesystem tests valid with long CPAN tester Perl paths:
the mock rsh checks the short loader overhead without imposing
an artificial 256-byte limit on the executable pathname.
- shorten mcp-fs remote bootstrap: embed the launcher byte length with
sprintf and append source directly via sysread without extra argv.
- raise sort_create/sort_page UID page maximum from 100 to 1000,
keeping the default at 100 and leaving message fetching and MOVE
batches capped at 100.
- enable multibroker-managed idle exit in mcp-http and mcp-ask-user
after 300 seconds, and mcp-imap after 3600 seconds (mcp-fs already
supported 300 seconds). Retain ask-user continuations; disposable
IMAP SORT snapshots are lost on idle exit. Retry declined idle
shutdown after the interval.
- add worker-local immutable UID SORT (SUBJECT DATE) snapshots for
subject-grouped classification: sort_create returns the first 100
UIDs, sort_page pages without re-sorting, sort_discard frees the
snapshot; one snapshot per worker, invalidated on restart.
- expose read-only UID THREAD ORDEREDSUBJECT through mcp-imap:
group by base subject with optional SEARCH filter and UID range,
retaining the complete nested server order without pagination.
- keep mcp-imap connections alive with an idle NOOP (250 seconds by
default, configurable via --keepalive, 0 disables); stop pinging
on failure, and reconnect on the next tool call without retrying
interrupted operations.
- allow shell-friendly instance names (ASCII alphanumerics, underscore,
hyphen, dot, @ and +), with separate strict managed-user names.
- fold small state-file locking and atomic replacement helper into
MCP.pm instead of a separate AnyEvent::MCP::File module.
- make --ask a shared common option, with per-option exclusion;
add --ask none to deny unresolved permissions and decline
downstream elicitation without prompting.
- document mcp-imap login keys individually in --help and manpage;
support tls connect/starttls/none (including explicit unencrypted IMAP)
and reset default ports on TLS mode changes.
- report LOGINDISABLED with no supported SASL mechanism cleanly on
IMAP password login, without obscure Authen::SASL warnings.
- add mcp_permissions to Simple: default permission engine, explicit
object or explicit undef; apply --ask and automatic rule overrides
centrally without dropping application-supplied automatic rules.
- give mcp-fs writable private /tmp and /var/tmp (mode 1777) even
with world-read; only shared-tmp or world-write exposes host
temporary directories. Make world-write formally imply shared-tmp
for permission checks; document the private/host lifetime distinction.
- add read-only mcp-imap previews for 25 UIDs, with bounded partial
MIME decoding, HTML link preservation and grouped IMAP FETCH calls.
- allow mcp-imap messages to fetch selected UIDs without SEARCH.
- actually truncate bounded IMAP part/raw responses to max_bytes,
not just flag them as truncated.
- use a 15-second HTTP read-inactivity timeout by default, suspended
while processing complete requests; respect explicit handle rtimeout.
- load MIME::Base64 in the HTTP server itself for encoded modern
Mcp-Name headers, without depending on the HTTP client loading it.
- log ordinary HTTP 404 responses at trace rather than warn,
including GET /; keep other HTTP rejection warnings.
- return 404 to GET / even when / is the MCP POST endpoint; drop
the unhelpful connection object address from HTTP rejection logs
while retaining the remote address and sanitized URI.
- reuse the latest saved per-dimension scope as the next permission
rule editor's default where offered, otherwise keep the original
conservative choice; native, YAD and terminal forms agree.
- handle the common token-only HTTP endpoint in warning logs:
redact known tokens without misclassifying unrelated paths.
- include bounded, JSON-escaped request paths in rejected HTTP request
warnings; omit queries and redact configured and attempted URL tokens.
- show captured helper status, stderr and stdout when the permission
UI test fails, and report remote file-patch results and file content
when the mock remote filesystem test fails (CPAN Testers diagnostics).
0.82 Fri 06 Nov 2026 15:53:46 CET
- add a first-permission-dialog walkthrough to Intro.pod, explaining
one-time versus persistent grants, rule scopes and exec stdin risks;
correct its description of logical workdir IDs.
- add common repeatable -s/--set KEY=VALUE process-local overrides
for trusted instance configuration, after program/instance defaults.
- key remote mcp-fs host permissions by --host alone, independent of
--rsh; add independent local/remote host scopes (this host by
default, or all hosts), retaining old unscoped saved rules.
Workdir scopes remain plain paths, independent of host.
- omit single-choice permission scope selectors from native, YAD and
terminal rule dialogs, automatically retaining the sole match in
saved rules without broadening their applicability.
- log rejected HTTP requests (status 400 and above) with method,
status and peer information, without leaking URL tokens; demote
ordinary connection/TLS errors to trace.
- do not warn on routine GET / requests; keep the normal 404
response without exposing a server-identification page.
- preserve mcp-vim subprocess stderr when its JSONL initialization
fails, instead of hiding the failure behind EOF and SIGPIPE.
- bootstrap remote mcp-fs over a short Perl command, streaming the
launcher source over stdin. Avoid rsh command length limits and
preserve worker input across exec by using exact sysread.
- format mcp-fs sandbox grants, tools, trusted configuration keys
and permission action classes as individually searchable POD items.
- give the mock remote filesystem test its running Perl interpreter
explicitly, rather than assuming it is in a fixed Unix PATH.
- avoid locale-dependent TCP error strings in reverse-connection tests,
and skip mcp-imap provider CLI tests when optional fork modules
are unavailable while retaining standalone provider parser tests.
0.81 Thu 05 Nov 2026 04:51:59 CET
- keep OAuth2 tests working without optional Mail::IMAPTalk,
IO::Socket::SSL or Authen::SASL; skip only worker-specific checks.
- support optional `mount-try.SUFFIX = ro:/path` or `rw:/path` in
mcp-fs configuration. Pass these directly as bubblewrap
--ro-bind-try/--bind-try for each invocation, without startup path
checks, locally and remotely; required mount.* entries are unchanged.
- support one remote host per mcp-fs instance with -h/--host and
-e/--rsh; resolve remote workdirs and available tools in a single
startup probe, then execute existing workers through a binary-framed
remote Perl launcher without installing any MCP modules remotely.
- use logical absolute pathnames (without resolving symlinks) as compact
workdir IDs across hosts; qualify remote permission scopes independently.
Named profiles remain shared between instances. Report cached remote
VCS markers and remote umask.
- reserve -h for application-specific options; --help remains common.
- test remote workers, external GNU utilities, permission isolation,
shell argument quoting and startup probing using a mock remote shell
and bubblewrap, including unsandboxed/auto behavior. Verify matching
workdir IDs for identical logical paths across local and remote
instances.
- make mock remote-agent tests independent of a local SSH_AUTH_SOCK
Disable redirects, retries and proxies; verify HTTPS certificates.
- derive browser permission origins from reported URLs, not a new
userscript field; keep older browser clients able to execute with
origin-scoped permissions.
- accept compatible browser-protocol minor versions; return empty
operation discovery for 1.0 clients instead of disconnecting them.
Direct rule saves no longer perform semantic validation.
- replace special-case subject, origin and workdir permission scopes with
named dimensions: metadata-driven prompts, generic match.NAME rule keys,
and engine-enforced matcher choices. Reject old request and rule fields;
no conversion or backward-compatible rule loading.
- preserve selected origin scopes when external permission helpers
forward persistent decisions through native MCP elicitation.
- add origin-scoped MCP permission rules, selectable independently of
code/tab scopes; mcp-webbrowser derives browser origins for
JavaScript and tab operations, with exact, any-port and any-origin
choices. Existing rules without origins continue to match all origins.
- use POSIX::uname instead of nonportable hostname -f for the XPCSE
browser nickname, consistent with HTTP URL wildcard host selection.
- make form helper test run via explicit ./ path, avoid early HTTP
timer races, and test filesystem discovery with optional tools absent.
- report browser protocol rejections through bounded WebSocket close
reasons; show abnormal disconnects in the userscript console and toast.
- document browser wire-protocol minor-version compatibility: accept
compatible older and newer clients without breaking base functionality.
- remove the obsolete private stdio permission-result bridge from
mcp-multibroker; use ordinary form elicitation.
- add per-tab operation discovery and calls to mcp-webbrowser, with
per-tab routing, ordinary MCP permissions and browser protocol 1.1;
the userscript initially advertises no extra operations.
- make the unsandboxed-warning test tolerate diagnostic output from
non-GNU utility probes (FreeBSD and BusyBox).
- add mcp-imap with one named password-authenticated account per instance,
bounded UID search, MIME reads, explicit mailbox/message mutations,
UIDPLUS-only targeted expunge, forked worker and MCP permissions.
- propagate XPCSE save response ETags back to Vim session metadata;
make stale upload HTTP status an editor error.
- require GNU sed in worker tool discovery; report missing-Perl diagnostics in tests.
- xpcse: forward Vim's :write! flag through mcp-vim to browser
uploads, without changing upload behavior yet.
- recommend rather than require WebSocket modules: only mcp-vim and
mcp-webbrowser use them; mcp-vim loads them only for browser clients,
and tests skip optional WebSocket coverage when unavailable.
0.65 Fri 23 Oct 2026 22:41:32 CEST
- fix mcp-webbrowser userscript title indicator duplicating prefixes on empty titles.
- use built scripts in make test PATH, avoiding source shebangs and
accidentally installed helpers in rule management tests.
- clarify browser execute code wrapper and reject function/symbol return
values instead of silently converting them to null.
- fix many bugs in the testsuite.
0.62 Thu 22 Oct 2026 13:32:52 CEST
- INCOMPATIBLE API CHANGE: mcp_getoptions now returns a hash reference instead of
a key/value list.
- Simple accepts server_name/server_version independently of the local
instance name, leaving server_info as an unmodified protocol override.
- query multibroker children in parallel for tool and broker discovery,
preserving tool order and returning partial results after 15 seconds
instead of blocking on an unresponsive child.
- accept a missing trailing slash on HTTP MCP endpoint URLs, working
around Claude's MCP connector wrongly dropping it from the configured URL,
thus corrupting it.
- allow omitted ports in reverse extension URLs, defaulting to port 80.
- fix MCP client/server version fields serialized as JSON numbers in 0.61.
0.61 Thu 22 Oct 2026 08:57:42 CEST
- resolve bind hostnames via AnyEvent::Socket instead of Socket::getaddrinfo.
- honor user-selected file permissions and preserve them across replacements.
- fix permission test fixture grants.
- fix activity log timestamp formatting on older perl versions.
- correct multibroker test tool count (including meta-instructions).
- fix perl 5.12 syntax errors in mcp-fs and mcp-vim.
0.6 Wed 21 Oct 2026 20:43:20 CEST
- 34k LOC of pure llm madness. but seems to work. yay.
0.0 Sat 03 Oct 2026 07:29:39 CEST
- original version, an AnyEvent::HTTP clone.
( run in 1.269 second using v1.01-cache-2.11-cpan-1bcd28dbaf1 )