blib/lib/AnyEvent/MCP/Server/Simple.pm

filter: Statementstmt 64.7% 331 / 511 Branchbran 48.6% 179 / 368 Conditioncond 39.6% 101 / 255 MC/DCmcdc 22.0% 30 / 136 Subroutinesub 73.5% 39 / 53 Podpod 100% 16 / 16 totaltotal 51.9% 696 / 1339 CC 358 SCAR 50.1
CC
358
Cov
54%
mcp_getoptions
435.6
mcp_getoptions
435.6
mcp_log_request
256.0
CRAP 150.0
« bin/anyevent-mcp-form-elicitation ↑ Summary bin/mcp-webbrowser »
1 =head1 NAME
2  
3 AnyEvent::MCP::Server::Simple - simple function interface for MCP servers
4  
5 =head1 SYNOPSIS
6  
7 use AnyEvent::MCP::Server::Simple;
8  
9 mcp_config
10 server_name => "example",
11 server_version => 0,
12 instructions => <<'EOF';
13 Use echo to return the supplied text.
14 EOF
15  
16 mcp_tool echo =>
17 "Return the supplied text.",
18 {
19 type => "object",
20 properties => { text => { type => "string" } },
21 required => ["text"],
22 },
23 sub {
24 my ($req, $args) = @_;
25  
26 $req->reply ({
27 content => [{ type => "text", text => $args->{text} }],
28 });
29 };
30  
31 mcp_start;
32  
33 =head1 DESCRIPTION
34  
35 For most MCP servers, registering a few tools and starting a transport is
36 enough. This module does just that: call C<mcp_tool> to register callbacks,
37 optionally configure the server with C<mcp_config>, then start it with
38 C<mcp_start>, C<mcp_stdio> or C<mcp_http>. Registration alone does not start
39 a server or an event loop.
40  
41 Human-readable descriptions and instructions are stripped of surrounding
42 whitespace and common indentation when registered, so indented here-documents
43 can be used naturally.
44  
45 C<mcp_start>, C<mcp_stdio> and C<mcp_http> are alternative blocking entry
46 points for a self-contained server. They run AnyEvent until shutdown; you
47 do not start another event loop. If your application already owns the server
48 lifetime or needs several transports, use the object interfaces instead.
49  
50 Simple uses L<AnyEvent::MCP::Server> and a default Toolset internally; it is
51 not a second server implementation. Applications needing custom dispatch,
52 such as a multibroker, can use the Server API directly.
53  
54 Start with L</TUTORIAL> for a complete server and a first client call.
55 For running the bundled servers without writing Perl, see
56 L<AnyEvent::MCP::Intro>.
57  
58 =head1 TUTORIAL
59  
60 This tutorial builds a small server, calls it, then adds options, permission
61 checks and asynchronous work. You do not need to implement JSON-RPC,
62 authentication or a transport. Simple supplies those parts; your program
63 declares tools and handles their arguments.
64  
65 For installation, connecting AI clients and configuring the bundled servers,
66 see L<AnyEvent::MCP::Intro>. The function reference follows this tutorial.
67  
68 =head2 A complete first server
69  
70 Save the following as C<echo-mcp>:
71  
72 #!/opt/bin/perl
73  
74 use common::sense;
75 use AnyEvent::MCP::Server::Simple;
76  
77 my $options = mcp_getoptions {
78 name => "echo-demo",
79 usage => "Usage: $0 [OPTION]...\n",
80 description => "Return text supplied to the echo tool.",
81 };
82  
83 @ARGV == 0
84 or die "Unexpected arguments\n";
85  
86 mcp_config
87 server_name => "echo-demo",
88 server_version => 1,
89 instructions => "Use echo to return the supplied text.";
90  
91 mcp_tool echo =>
92 "Return the supplied text.",
93 {
94 type => "object",
95 properties => {
96 text => {
97 type => "string",
98 maxLength => 4096,
99 },
100 },
101 required => ["text"],
102 },
103 sub {
104 my ($req, $args) = @_;
105  
106 my $text = $args->{text};
107 defined $text and !ref $text and length $text <= 4096
108 or die "text must be a string of at most 4096 characters\n";
109  
110 $req->reply ({
111 content => [{ type => "text", text => $text }],
112 });
113 };
114  
115 mcp_start %$options;
116  
117 Use your installed Perl's explicit path in the shebang, or invoke the file
118 with C<perl> as in the commands below.
119  
120 C<mcp_getoptions> parses the common server options and returns startup
121 settings. C<mcp_config> declares protocol metadata and instructions.
122 C<mcp_tool> registers a description, input schema and callback.
123 C<mcp_start> constructs the transport and runs AnyEvent until shutdown.
124 Register everything before starting: code after C<mcp_start> runs only
125 when the server stops.
126  
127 The input schema tells the client what to supply. The server does B<not>
128 validate arguments against JSON Schema, so the callback checks the value it
129 actually uses. A missing text, array or object fails as a tool error.
130 The example allows an empty string.
131  
132 C<$req> is an L<AnyEvent::MCP::Server::Request>; C<$args> is its argument
133 hash reference. Replying finishes the request. Merely returning from the
134 callback does not. You supply the MCP result, and the server supplies the
135 JSON-RPC envelope.
136  
137 =head2 Start and call the server
138  
139 Inspect the common options with:
140  
141 perl echo-mcp --help
142  
143 For a client launching a local subprocess, configure:
144  
145 perl /absolute/path/to/echo-mcp --stdio
146  
147 The client must launch the process itself. Stdin and stdout carry MCP,
148 so starting the program in a terminal and typing text at it is not a test
149 of the echo tool. Print diagnostics to stderr, not stdout.
150  
151 You can make a first call without an AI client. Save this as C<try-echo>
152 in the same directory as C<echo-mcp>:
153  
154 use common::sense;
155 use AnyEvent;
156 use AnyEvent::MCP::Client::JSONL;
157  
158 my $client = AnyEvent::MCP::Client::JSONL->new (
159 command => [$^X, "./echo-mcp", "--stdio"],
160 );
161  
162 my $cv = AE::cv;
163  
164 $client->call (echo => { text => "hello" }, sub {
165 $cv->send (@_);
166 });
167  
168 my ($success, $result) = $cv->recv;
169 $success
170 or die "$result->{message}\n";
171 !$result->{isError}
172 or die "$result->{content}[0]{text}\n";
173  
174 print $result->{content}[0]{text}, "\n";
175  
176 Run C<perl try-echo>. It prints:
177  
178 hello
179  
180 The JSONL client starts the server, connects and negotiates the protocol on
181 first use. C<$^X> chooses the same Perl interpreter as the test client.
182 The condition variable keeps the event loop running until the reply arrives.
183 Keep C<$client> alive while its operations are outstanding.
184  
185 There are two success checks. C<$success> means the JSON-RPC operation
186 completed successfully; a tool can still return C<isError> in that result.
187 This client expects our echo tool's text result. A general client must handle
188 other MCP content representations too.
189  
190 To use HTTP, start the server in one terminal:
191  
192 perl echo-mcp --bind :31742
193  
194 and retrieve its URL in another:
195  
196 perl echo-mcp --bind :31742 --print-url
197  
198 Configure that URL in your MCP client and ask it to call echo with text
199 C<hello>. Both commands use instance C<echo-demo>, unless you override it
200 with C<--name>. Repeat the same listener overrides when printing the URL.
201 C<--print-url> prints the address and exits; it does not start a server.
202  
203 For the small Perl client above, replace the JSONL import and constructor
204 with:
205  
206 use AnyEvent::MCP::Client::HTTP;
207  
208 my $client = AnyEvent::MCP::Client::HTTP->new (
209 url => $ARGV[0],
210 );
211  
212 Pass the printed URL as its first command-line argument.
213 The rest of the call and result handling stays the same.
214  
215 C<mcp_start> supplies named HTTP settings and a token derived from the
216 private global secret. Stdio needs no HTTP configuration. C<name> selects
217 local settings and credentials; C<server_name> identifies the advertised
218 MCP implementation. The two need not be the same.
219 See L<AnyEvent::MCP::Intro/CONFIGURING YOUR SETUP>.
220  
221 =head2 Add an application option
222  
223 Suppose you want the server user to choose the maximum text length.
224 Replace the original C<mcp_getoptions> call with:
225  
226 my $max_length = 4096;
227  
228 my $options = mcp_getoptions (
229 {
230 name => "echo-demo",
231 usage => "Usage: $0 [OPTION]...\n",
232 description => "Return text supplied to the echo tool.",
233 options => [
234 ["--max-length N", "Maximum text length in characters"],
235 ],
236 },
237 "max-length=i" => \$max_length,
238 );
239  
240 $max_length > 0
241 or die "--max-length must be positive\n";
242  
243 Use C<$max_length> in both the schema's C<maxLength> and the callback's
244 length check. The server user can then start:
245  
246 perl echo-mcp --stdio --max-length 1000
247  
248 The option specification is passed to L<Getopt::Long>. The C<options>
249 entries supply human-readable help; they do not register options.
250 The later tool examples use the original 4096-character limit; use your
251 chosen limit in them too if you keep this option.
252 Common options such as C<--stdio>, C<--bind> and C<--help> remain available.
253  
254 If your server also takes positional arguments, validate the remaining
255 C<@ARGV> after C<mcp_getoptions>. It handles C<--help> and C<--print-url>
256 before that validation, so the user can retrieve an HTTP URL without
257 supplying an application workdir or starting the application.
258  
259 Settings affecting URL discovery, such as C<name> and C<path>, should be
260 available to C<mcp_getoptions> through its leading settings hash or an
261 earlier C<mcp_config> call. A setting supplied only after the parser exits
262 for C<--print-url> cannot affect that printed URL.
263  
264 =head2 Choose a result representation
265  
266 Our echo callback returns one text content item. Use C<reply> when the
267 representation matters: text, other content types, a larger result or a
268 particular MCP result shape.
269  
270 For an ordinary result object, you can replace the reply with:
271  
272 $req->result ({ text => $text, length => length $text });
273  
274 C<result> returns that hash as C<structuredContent> and also serializes it
275 as JSON in one text content item. Clients consuming only text can still
276 see the data, but it is deliberately duplicated. Wrap arrays or scalars in
277 an object, or use C<reply> to choose a different representation.
278  
279 To report a tool failure explicitly:
280  
281 $req->error ("The requested operation cannot be completed");
282  
283 A synchronous exception from the handler also becomes a tool-error result.
284 Malformed protocol requests and an unknown tool name are handled by the
285 server. Your callback does not construct a JSON-RPC response itself.
286  
287 Reply once. Code that calls C<reply>, C<result> or C<error> and then calls
288 another reply method is a programming error. Keep a final reply separate
289 from the work leading to it so the completion point is easy to see.
290  
291 =head2 Add a permission check before changing state
292  
293 Authentication alone does not decide which tool operations a user allows.
294 For an example with a side effect but no external worker, add a tool that
295 stores one note in the server's memory.
296  
297 Add this before registering the tools:
298  
299 use AnyEvent::MCP::Server::Permissions;
300  
301 my $note;
302  
303 mcp_config permissions => AnyEvent::MCP::Server::Permissions->new (
304 name => "echo-notes",
305 actions => {
306 remember => "Replace the server's in-memory note",
307 },
308 );
309  
310 Then register this tool before C<mcp_start>:
311  
312 mcp_tool remember =>
313 "Replace the server's in-memory note with the supplied text.",
314 {
315 type => "object",
316 properties => {
317 text => { type => "string", maxLength => 4096 },
318 },
319 required => ["text"],
320 },
321 sub {
322 my ($req, $args) = @_;
323  
324 my $text = $args->{text};
325 defined $text and !ref $text and length $text <= 4096
326 or die "text must be a string of at most 4096 characters\n";
327  
328 $req->require_permission ({
329 tool => $req->{tool},
330 action => "remember",
331 sandbox_grants => [],
332 reason => "replace the server's in-memory note",
333 });
334  
335 $note = $text;
336  
337 $req->result ({ remembered => length $note });
338 };
339  
340 Restart the server and call remember through your client. The default
341 permission helper asks on the server machine. Allow once permits this
342 invocation. Allow always saves a rule for action C<remember>; subsequent
343 matching calls do not ask again. The note itself lasts only for this
344 server process and is shared by its clients.
345  
346 The permission engine's name C<echo-notes> selects its default policy file:
347  
348 ~/.config/anyevent-mcp/rules/echo-notes.ini
349  
350 The actual directory follows C<XDG_CONFIG_HOME> when set.
351 This is the shared engine's default convention, different from mcp-fs's
352 C<rules/fs-NAME.ini>. Manage it using C<anyevent-mcp manage-rules-file>
353 with the actual pathname, or supply C<file> to the engine explicitly.
354  
355 For example, a manually written allow rule is:
356  
357 [rule]
358 decision=allow
359 action=remember
360 sandbox-grants=
361  
362 The empty grant list is intentional. This tool updates an in-memory value;
363 it does not launch a sandboxed worker. C<action> is the operation class
364 to authorize, while C<sandbox_grants> describes worker authority.
365  
366 The permission engine checks policy; it does not restrict filesystem or
367 network access by itself. If you add file or command tools, define the
368 necessary grants and enforce the returned set through your worker or
369 sandbox. Do not copy C<sandbox_grants =E<gt> []> into a file-writing
370 handler and assume it confines access.
371  
372 Here the permission name is deliberately fixed and independent of the
373 HTTP instance name. If you want each C<--name> to have separate policy,
374 pass C<$options{name}> as the permission engine's name instead.
375  
376 =head2 Why checks must precede side effects
377  
378 When permission is missing, C<require_permission> throws a special
379 exception. Server catches it, asks, and may invoke the handler again.
380 The assignment to C<$note> therefore comes B<after> the check.
381  
382 With a local prompt, the server retries internally. Modern MCP form asking
383 returns C<input_required>; the client repeats the call with its answer.
384 Earlier one-time grants survive permission retries within this invocation,
385 but do not authorize the next call. Saved rules are rechecked.
386  
387 Do not catch that exception as an ordinary failure around the permission
388 check. It must reach Server's synchronous dispatch boundary.
389 For several checks, complete all of them before modifying state or starting
390 asynchronous work. An C<on_request> hook also runs on retry, so it must not
391 perform a once-only side effect before the handler's checks.
392  
393 To choose client-side form asking for this example:
394  
395 PERL_ANYEVENT_MCP_PERMISSION_ASK=auto perl echo-mcp --stdio
396  
397 C<auto> uses modern form elicitation when the client advertises support,
398 otherwise the local helper. C<mcp> requires that support; C<helper> keeps
399 the prompt local. The tiny try-echo client advertises no form support,
400 so auto uses the helper there. To handle forms in a Perl client, see
401 L<AnyEvent::MCP::Client/on_request> and
402 L<AnyEvent::MCP::Permissions::Ask/elicitation>.
403  
404 For grant definitions, subject scopes and multi-path operations, see
405 L<AnyEvent::MCP::Server::Permissions> and
406 L<AnyEvent::MCP::Server::Toolset/Permission checks and retries>.
407  
408 =head2 Let an asynchronous operation finish later
409  
410 A tool callback runs in the AnyEvent event loop. Blocking it with C<sleep>
411 or a synchronous long-running command also blocks other requests.
412  
413 Add C<use AnyEvent;> and register the following before C<mcp_start>:
414  
415 mcp_tool delayed_echo =>
416 "Return the supplied text after a delay of up to 60 seconds.",
417 {
418 type => "object",
419 properties => {
420 text => { type => "string", maxLength => 4096 },
421 seconds => {
422 type => "integer",
423 minimum => 0,
424 maximum => 60,
425 },
426 },
427 required => ["text", "seconds"],
428 },
429 sub {
430 my ($req, $args) = @_;
431  
432 my $text = $args->{text};
433 defined $text and !ref $text and length $text <= 4096
434 or die "text must be a string of at most 4096 characters\n";
435  
436 my $seconds = $args->{seconds};
437 defined $seconds and !ref $seconds
438 and $seconds =~ /\A[0-9]+\z/ and $seconds <= 60
439 or die "seconds must be an integer from 0 to 60\n";
440  
441 $req->progress (0, 1, "Waiting");
442  
443 my $timer = AnyEvent->timer (after => $seconds, cb => sub {
444 $req->{finished}
445 and return;
446  
447 $req->progress (1, 1, "Done");
448 $req->reply ({
449 content => [{ type => "text", text => $text }],
450 });
451 });
452  
453 $req->{on_cancel} = sub {
454 undef $timer;
455 };
456 };
457  
458 The tool is advertised as C<delayed-echo>, because registration converts
459 underscores to hyphens. Ask the client to call it with text C<hello> and
460 seconds C<2>. The callback returns immediately; the timer supplies the reply
461 later. Other requests can run while it waits.
462  
463 Keep watcher objects alive while they are needed. Here the cancellation
464 callback retains C<$timer>, and the timer's callback retains C<$req> and
465 C<$text>. Cancellation releases the timer. Replying finishes the request
466 and removes its cancellation callback, releasing the watcher as well.
467 No separate job registry is needed for this example.
468  
469 Check C<finished> in late completion callbacks before replying.
470 Cancellation sets both C<finished> and C<cancelled> and sends no reply.
471 For subprocesses or network work, the cancellation callback should stop
472 that operation and release its resources instead of merely abandoning
473 the eventual reply.
474  
475 Server catches exceptions during synchronous dispatch, not exceptions
476 from a later timer or I/O callback. If an asynchronous operation can fail,
477 handle that failure in its completion callback and report it with
478 C<error> or C<reply>, provided the request is still active.
479  
480 C<progress> only sends when the caller supplied a progress token.
481 Delivery is best effort; the HTTP server in this distribution does not
482 deliver progress notifications. A client without progress display can
483 still receive the final result.
484  
485 =head2 When to use the object interfaces
486  
487 Simple owns one default Toolset and the blocking server lifetime.
488 That is useful for a small standalone program. If you already run an
489 event loop, want multiple transports or tool registries, or need custom
490 protocol dispatch, construct the objects directly.
491  
492 L<AnyEvent::MCP::Server::Toolset> registers reusable tools.
493 L<AnyEvent::MCP::Server> handles the protocol.
494 L<AnyEvent::MCP::Server::HTTP> and L<AnyEvent::MCP::Server::JSONL> manage
495 connections. L<AnyEvent::MCP::Server::Request> describes request fields,
496 replies, progress and cancellation. The same tool callback model applies
497 at both levels.
498  
499 =head1 FUNCTIONS
500  
501 =over
502  
503 =item mcp_config %config
504  
505 Adds server configuration. Repeated calls extend or replace previously declared
506 values. C<instructions> is treated as human-readable text and normalized.
507  
508 Server and transport options are passed to the underlying objects.
509 Common options include:
510  
511 =over
512  
513 =item name => $instance
514  
515 Local instance name used to select configuration and credentials. Independent
516 of the name reported to MCP clients.
517  
518 =item server_name => $name
519  
520 Advertised MCP server implementation name. Defaults to C<AnyEvent::MCP>.
521  
522 =item server_version => $version
523  
524 Advertised application version, not the MCP protocol revision. Accepts
525 an ordinary Perl version number; Simple stringifies it for MCP.
526 Defaults to the AnyEvent::MCP library version.
527  
528 =item server_info => { name => $name, version => $version }
529  
530 Raw MCP server identity, passed through unchanged to the underlying
531 server. Cannot be combined with C<server_name> or C<server_version>.
532  
533 =item instructions => $text
534  
535 Human-readable guidance for the client, normalized when configured.
536  
537 =item short_instructions => $text
538  
539 Optional condensed guidance for finding this server's tools. Used as the
540 advertised MCP instructions when C<auto_instructions> is enabled.
541  
542 =item auto_instructions => $boolean
543  
544 Enabled by default. Exposes full instructions through the generated
545 C<meta-instructions> tool while advertising the short instructions if set.
546 When short or custom instructions are provided, append a brief hint pointing
547 to the full tool description; otherwise advertise full instructions as before.
548 Disable to advertise full instructions and omit the generated tool.
549  
550 =item custom_instructions => $text
551  
552 Instance-specific purpose prepended to advertised instructions. Can also be
553 set through C<--custom-instructions> or C<custom_instructions> in the program
554 or instance section of the global INI configuration.
555  
556 =item on_request => $callback->($server, $req)
557  
558 Synchronous hook before each dispatch attempt. For example, refresh
559 database state here. This does not replace dispatch or receive a
560 completion callback, and permission retries can invoke it again.
561  
562 =item on_start => $callback->($server)
563  
564 Called after the transport is ready, before entering the event loop.
565 Use it for startup information or installing watchers. Stdout carries
566 protocol messages in stdio mode; print diagnostics to stderr.
567 The callback must not block.
568  
569 =item idle_exit => $seconds
570  
571 Optional positive idle time for spawned stdio servers. With a multibroker
572 advertising C<anyevent-mcp/multibroker> version 1, Simple requests shutdown
573 once no MCP requests have been active for that long. The broker can ignore
574 the request. HTTP servers, ordinary clients and servers without this
575 option are unaffected.
576  
577 =back
578  
579 See L<AnyEvent::MCP::Server> for further protocol options and events.
580  
581 =item mcp_tool $name, $description, $input_schema, $callback->($req, $args)
582  
583 Registers a tool named C<$name> with C<$description> and the JSON Schema
584 hash reference C<$input_schema>. C<$description> is normalized like
585 C<instructions>.
586  
587 C<$callback> receives an L<AnyEvent::MCP::Server::Request> object C<$req>
588 and its C<< $req->{args} >> hash reference as C<$args>, for convenience.
589  
590 Tools complete the request with C<< $req->reply ($result) >>, or use
591 C<< $req->result ($data) >> and C<< $req->error ($message) >> for convenience.
592 Request context is available directly in
593 the hash, for example C<< $req->{tool} >> and C<< $req->{server} >>.
594  
595 =item $server_options = mcp_getoptions ({ %settings }, @getopt_options)
596  
597 Parse the switches documented in L</COMMON COMMAND-LINE OPTIONS> alongside
598 application-specific L<Getopt::Long> option specifications:
599  
600 my $verbose;
601 my $options = mcp_getoptions (
602 {
603 usage => "Usage: $0 [OPTION]... WORKDIR\n",
604 description => "Provide example tools through MCP.",
605 option_heading => "Example options:",
606 options => [
607 ["--verbose", "Show additional diagnostics"],
608 ],
609 examples => " $0 --stdio ./project",
610 path => "/",
611 },
612 "verbose!" => \$verbose,
613 );
614 @ARGV == 1 or die "workdir required\n";
615 mcp_start %$options;
616  
617 The optional leading hash accepts these help settings:
618  
619 =over
620  
621 =item usage => $text
622  
623 Usage synopsis, including its trailing newline. A default synopsis is
624 generated when omitted.
625  
626 =item description => $text
627  
628 Introductory help paragraph.
629  
630 =item options => [[$label, $description]...]
631  
632 Application option labels and descriptions. A plain string among the
633 pairs starts a new section; a string at the beginning replaces the
634 default section heading.
635  
636 =item option_heading => $text
637  
638 Initial section heading, defaulting to C<Application options:>.
639  
640 =item examples => $text
641  
642 Preformatted examples.
643  
644 =back
645  
646 See L</COMMON COMMAND-LINE OPTIONS> for the full reference to shared
647 server switches. Application-specific Getopt::Long options are parsed alongside them.
648  
649 These switches also appear in C<--help>; application options are passed
650 through to L<Getopt::Long>. Other leading hash settings (e.g. C<path>,
651 C<auth>, C<url_scheme>) go to C<mcp_start>. Parse positional C<@ARGV>
652 in the application; C<mcp_getoptions> deliberately does not require them
653 for help or URL discovery. Default activity logging includes asynchronous
654 tool failures and formats time, program, instance and PID. Environment
655 C<PERL_ANYEVENT_LOG> can select destinations and verbosity.
656  
657 =item mcp_tool_help ($enabled, @toolsets)
658  
659 If C<$enabled> is true, print the definitions registered in the supplied
660 L<AnyEvent::MCP::Server::Toolset> objects and exit. Otherwise do nothing.
661 Call after registering tools but before starting listeners for executables
662 which manage their own toolsets. Only registered tools appear.
663  
664 =item mcp_log $message
665  
666 Emit operator-facing activity to the configured AnyEvent::Log destination,
667 bypassing its diagnostic verbosity filter. C<--quiet> suppresses this log.
668  
669 =item mcp_log_request ($server, $req, %extra)
670  
671 C<on_request> callback to report tool invocations once across permission
672 retries, and log tool-error replies, including asynchronous ones. It logs
673 selected arguments rather than entire request or reply payloads. This includes
674 JSON-quoted previews of command arguments and VCS filenames (up to four,
675 80 characters each), and Vim C<ex> commands (up to 200 characters).
676 These can contain sensitive text. The Simple starters install it by default;
677 custom servers can use it too.
678 C<%extra> appends application-specific C<key=value> fields in key order.
679 Sanitize sensitive arguments before passing them.
680  
681 =item mcp_start %config
682  
683 Starts and runs the usual server. When C<stdio> is true or
684 C<PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL> is C<stdio>, uses C<mcp_stdio>.
685 Otherwise starts HTTP without printing its URL. HTTP-capable executables
686 provide C<--print-url> to retrieve the URL explicitly.
687  
688 The HTTP defaults are IPv4 loopback, a stable name-derived port in
689 16384..32767, and C</> as the endpoint path.
690 Without explicit C<tokens>, one server-specific token is derived from
691 the private global secret. The selected token authenticates either its URL
692 path or an
693 C<Authorization: Bearer TOKEN> header at the clean URL returned by
694 C<< $server->url (0) >>. The corresponding executable's C<--print-url>
695 option prints the first accepted token in its URL.
696  
697 C<name> selects the C<[instance NAME]> configuration section and credential.
698 It defaults to C<default>.
699 Named settings C<bind>, C<path>, C<url_host>, C<url_scheme>, C<tokens>,
700 C<tls_cert> and C<tls_key> are loaded from the global configuration.
701 Explicit C<tokens> (an ordered,
702 nonempty array reference of URL-safe strings) replaces the configured list
703 and the derived default. Every token works in the URL and bearer header.
704 An explicit C<bind> overrides the configured bind address. Other arguments
705 override these settings.
706  
707 The global secret is generated automatically when needed; see
708 L<AnyEvent::MCP/GLOBAL CONFIGURATION>. No configuration is loaded for stdio.
709 HTTP startup neither prints to stdout nor changes its buffering.
710 C<mcp_start> does not parse C<@ARGV>; applications parse their own options.
711 The bundled executables use C<mcp_getoptions>, which handles shared
712 options and URL discovery before starting the event loop.
713  
714 =item mcp_connect %config
715  
716 Run a reverse-connecting JSONL server using C<connect =E<gt>
717 "http[s]://host:port/token/alias">. HTTPS verifies the server certificate
718 and hostname. It sends the authenticated extension hello only after the
719 transport is established, then serves MCP over the socket. Refused TCP
720 connections retry every second for at most sixty attempts, and unexpected
721 established disconnects start a new retry period. Other TCP setup and TLS
722 handshake errors are reported and stop the server.
723 Calls are cancelled rather than replayed.
724 This connection has no spawned-child lifecycle authority.
725  
726 =item mcp_stdio %config
727  
728 Creates and runs a server over stdin/stdout. Arguments override the collected
729 configuration. Stdout buffering is disabled. On stdin EOF, pending replies
730 finish and stdout drains before
731 this function returns. Stream errors close the connection and cancel pending
732 requests.
733  
734 =item mcp_http %config
735  
736 Creates and runs an HTTP server. For example:
737  
738 mcp_http
739 host => "127.0.0.1",
740 port => 31740,
741 path => "/mcp/",
742 tokens => ["your-long-random-secret"];
743  
744 Arguments override the collected configuration. Unlike C<mcp_start>, this
745 function does not derive or supply authentication. B<Always> pass C<tokens>,
746 or explicitly pass C<auth =E<gt> "none"> when a trusted embedding layer
747 enforces access. Omitting both is an error, not an unauthenticated default.
748 It does not print a URL; use
749 C<on_start> for application-specific startup output. Neither function
750 implements OAuth or Basic authentication. See
751 L<AnyEvent::MCP::Server::HTTP/AUTHENTICATION> for details.
752  
753 All three starters return when the server is closed or on C<SIGINT> or
754 C<SIGTERM>. Signal shutdown closes connections and cancels outstanding
755 requests. The signal watchers belong to the blocking call.
756  
757 =back
758  
759 =head1 COMMON COMMAND-LINE OPTIONS
760  
761 C<mcp_getoptions> parses these options for executables using
762 L<AnyEvent::MCP::Server::Simple>. The executable's own OPTIONS section
763 documents any additional switches or differences in shared-option behavior.
764  
765 =over
766  
767 =item --name NAME
768  
769 Select the instance (default C<default>). NAME starts with a letter or
770 underscore, followed by letters, digits, underscores or hyphens.
771 Selects C<[instance NAME]> configuration, derived HTTP port and credentials;
772 does not change the advertised MCP implementation name.
773 Example: C<--name project>.
774  
775 =item --bind ADDRESS[:PORT]
776  
777 Override HTTP listening address and port. Defaults to C<127.0.0.1> and a
778 stable instance-derived port in 16384..32767. C<:31740> uses the loopback
779 address and port 31740; C<127.0.0.1:31740> specifies both.
780 Port zero requests an ephemeral port and is incompatible with
781 C<--print-url>. Ignored for stdio-only startup.
782  
783 =item --tls-cert FILE
784  
785 Enable opportunistic HTTPS using a PEM certificate chain. Without
786 C<--tls-key>, FILE must also contain the private key. The same listener
787 continues to accept plain HTTP.
788  
789 =item --tls-key FILE
790  
791 Private-key PEM file for C<--tls-cert>. If supplied alone, FILE must
792 contain both certificate chain and private key. Requires C<Net::SSLeay>.
793  
794 =item --token TOKEN
795  
796 Accept TOKEN for HTTP authentication. Repeat to accept multiple tokens.
797 Explicit tokens replace configured or master-secret-derived defaults.
798 Tokens work both as credential-bearing URL components and with the
799 C<Authorization: Bearer TOKEN> header.
800 Example: C<--token first --token second>.
801  
802 =item -s, --set KEY=VALUE
803  
804 Override one trusted configuration entry for the selected instance in this
805 process. Applied after C<[program NAME]> and C<[instance NAME]> defaults,
806 without changing the configuration file. Repeat to override multiple entries;
807 the last assignment to a key wins. Empty values suppress inherited settings,
808 and additional equals signs belong to the value. The supported keys depend
809 on the server (for example, C<executable.perl> and C<prepend-path> in
810 L<mcp-fs>). Example: C<-s executable.perl=/opt/perl/bin/perl>.
811  
812 =item --stdio
813  
814 Serve MCP JSONL on stdin/stdout rather than the default HTTP listener.
815 Applications with auxiliary listeners can keep those active. Cannot
816 combine explicitly with C<--connect>.
817  
818 =item --connect URL
819  
820 Reverse-connect to an upstream multibroker. For example:
821 C<http://host:port/TOKEN/alias> or C<https://host:port/TOKEN/alias>.
822 HTTPS requires successful certificate and hostname verification; it
823 never falls back to plaintext. Replaces the default MCP listener and
824 overrides implicit stdio selection. Cannot combine with explicit
825 C<--stdio>.
826  
827 =item --custom-instructions TEXT
828  
829 Override configured instance-purpose guidance describing when MCP
830 clients should use the server.
831 Example: C<--custom-instructions 'Use for build logs'>.
832  
833 =item --auto-allow TOOL[,ACTION[,CAPABILITY]]
834  
835 Add a process-local permission allow rule, repeatable. TOOL identifies
836 the permission-checked tool; ACTION and CAPABILITY narrow the match.
837 Missing fields and C<*> match anything.
838 Example: C<--auto-allow '*,read,workdir-read'>.
839 Rules run in command-line order before saved rules; they cannot grant
840 permissions to tools that do not check permissions.
841 See L<AnyEvent::MCP::Server::Permissions/auto_rules>.
842  
843 =item --auto-deny TOOL[,ACTION[,CAPABILITY]]
844  
845 Add a repeatable process-local deny rule with the same matching syntax
846 and evaluation order as C<--auto-allow>.
847 Example: C<--auto-deny '*,exec'>.
848  
849 =item --quiet
850  
851 Suppress routine tool activity and tool-failure logging. Warnings and
852 ordinary diagnostics remain; C<PERL_ANYEVENT_LOG> determines diagnostic
853 levels and destinations.
854  
855 =item --print-url[=USER]
856  
857 Print credential-bearing URLs and exit without starting a listener.
858 With managed users, prints each effective enabled user's URL, or only
859 the exact username USER. Comments identify scope-qualified principals
860 and the selected auxiliary connection user. With configured TLS, HTTPS
861 is printed before HTTP. Explicit tokens retain a single-token output
862 and cannot be combined with a user selector. Requires a predictable,
863 nonzero port and a persistent master secret for derived credentials.
864 Example: C<--name project --print-url=claude>.
865  
866 =item --print-urls
867  
868 Alias for C<--print-url>.
869  
870 =item --tool-help
871  
872 Print currently registered tool names, descriptions, argument types,
873 required fields and defaults; exit without starting the MCP listener.
874 Registered tools can depend on installed utilities and application setup.
875  
876 =item --help
877  
878 Print shared and application-specific command-line help; exit without
879 starting a server. Invalid options instead report usage.
880  
881 =back
882  
883 =cut
884  
885 package AnyEvent::MCP::Server::Simple;
886  
887 296 ▶use common::sense;
Subroutine BEGIN: called CC=1 SCAR=0.0
888  
889 296 ▶use Exporter ();
Subroutine BEGIN: called CC=1 SCAR=0.0
890 296 ▶use JSON::XS ();
Subroutine BEGIN: called CC=1 SCAR=0.0
891 296 ▶use Scalar::Util qw(refaddr);
Subroutine BEGIN: called CC=1 SCAR=0.0
892  
893 296 ▶use AnyEvent ();
Subroutine BEGIN: called CC=1 SCAR=0.0
894 296 ▶use AnyEvent::Log ();
Subroutine BEGIN: called CC=1 SCAR=0.0
895 296 ▶use AnyEvent::MCP ();
Subroutine BEGIN: called CC=1 SCAR=0.0
896 296 ▶use AnyEvent::MCP::Server::Toolset ();
Subroutine BEGIN: called CC=1 SCAR=0.0
897  
898 296 our @ISA = qw(Exporter);
899 296 our @EXPORT = qw(mcp_config mcp_tool mcp_getoptions mcp_tool_help mcp_log mcp_log_request mcp_start mcp_stdio mcp_http mcp_connect);
900  
901 my %config = (
902 auto_instructions => 1,
903 on_request => \&mcp_log_request,
904 0 ▶ on_connection_error => sub {
Subroutine __ANON__: not called CC=5 SCAR=34.0
905 0 my ($server, $handle, $error) = @_;
906 0 my $info = $handle->{mcp_peer}{client_info};
907 0 ▶ my $name = ref $info eq "HASH" ? $info->{name} : undef;
Branch: 1 branch
BranchTrueFalseTotal
ref $info eq 'HASH' ? : 0 0 0
908 my @details = (
909 "id=" . sprintf ("%x", refaddr $handle),
910 0 ▶ defined $handle->{mcp_remote} ? "remote=$handle->{mcp_remote}" : (),
Branch: 2 branches
BranchTrueFalseTotal
defined $handle->{'mcp_remote'} ? : 0 0 0
defined $name && !ref($name) ? : 0 0 0
Condition0%0/3
defined $name and not ref $name
!ll&&!rl&&r
000
MC/DC0%0/2
defined $name and not ref $name
defined $name not ref $name
Truth table0%0/3
A and not(B)
A= defined $nameB= not ref $name
ABresult
0X0
100
111
911 defined $name && !ref $name ? "client=" . JSON::XS::encode_json (substr $name, 0, 80) : (),
912 );
913 0 AE::log trace => "MCP connection " . join (" ", @details) . ": $error";
914 },
915 296 );
916 296 my $toolset = AnyEvent::MCP::Server::Toolset->new;
917 296 my $quiet;
918  
919 sub _run;
920  
921 # operational messages go to the configured AnyEvent::Log destination,
922 # independently of the diagnostic verbosity filter.
923 4444 ▶sub mcp_log {
Subroutine mcp_log: called CC=2 SCAR=9.2
Pod documented
924 0 ▶ return if $quiet;
Subroutine mcp_log: not called CC=2 SCAR=9.2
Pod documented
Branch: 2 branches
BranchTrueFalseTotal
if $quiet 30 4414 4444
if $quiet 0 0 0
925 0 $AnyEvent::Log::LOG->log (info => @_);
926 }
927  
928 4087 ▶sub mcp_log_request {
Subroutine mcp_log_request: called CC=35 SCAR=55.5
Pod documented
929 0 ▶ my ($server, $req, %extra) = @_;
Subroutine mcp_log_request: not called CC=35 SCAR=55.5
Pod documented
930  
931 0 ▶ return unless $req->{method} eq "tools/call";
Branch: 2 branches
BranchTrueFalseTotal
unless $req->{"method"} eq "tools/call" 303 3784 4087
unless $req->{"method"} eq "tools/call" 0 0 0
932 0 ▶ return if $req->{mcp_logged}++;
Branch: 2 branches
BranchTrueFalseTotal
if $req->{"mcp_logged"}++ 3 3781 3784
if $req->{"mcp_logged"}++ 0 0 0
933  
934 0 my $args = $req->{args};
935 0 my $vcs = $req->{tool} =~ /\Avcs-(?:diff|status|log)\z/;
936 0 my @details;
937 0 ▶ for (qw(target workdir path cwd), $vcs ? "backend" : ()) {
Branch: 2 branches
BranchTrueFalseTotal
$vcs ? : 1182 2599 3781
$vcs ? : 0 0 0
938 push @details, "$_=" . (substr $args->{$_}, 0, 160)
939 0 ▶ if defined $args->{$_} && !ref $args->{$_};
Branch: 2 branches
BranchTrueFalseTotal
if defined $args->{$_} and not ref $args->{$_} 2910 13396 16306
if defined $args->{$_} and not ref $args->{$_} 0 0 0
Condition50%3/6
defined $args->{$_} and not ref $args->{$_}
!ll&&!rl&&r
1339422910
defined $args->{$_} and not ref $args->{$_}
!ll&&!rl&&r
000
MC/DC100%2/2
defined $args->{$_} and not ref $args->{$_}
defined $args->{$_} not ref $args->{$_}
MC/DC0%0/2
defined $args->{$_} and not ref $args->{$_}
defined $args->{$_} not ref $args->{$_}
Truth table100%3/3
A and not(B)
A= defined $args->{$_}B= not ref $args->{$_}
ABresult
0X0
100
111
Truth table0%0/3
A and not(B)
A= defined $args->{$_}B= not ref $args->{$_}
ABresult
0X0
100
111
940 }
941 0 push @details, substr +(join " ", @{$args->{ranges}}), 0, 180
942 0 ▶ if ref $args->{ranges} eq "ARRAY";
Branch: 2 branches
BranchTrueFalseTotal
if ref $args->{"ranges"} eq "ARRAY" 11 3770 3781
if ref $args->{"ranges"} eq "ARRAY" 0 0 0
943 0 ▶ for my $key ("argv", $vcs ? "files" : ()) {
Branch: 2 branches
BranchTrueFalseTotal
$vcs ? : 1182 2599 3781
$vcs ? : 0 0 0
944 0 ▶ next unless ref $args->{$key} eq "ARRAY" && @{$args->{$key}};
Branch: 2 branches
BranchTrueFalseTotal
unless ref $args->{$key} eq "ARRAY" and @{$args->{$key};} 3593 1370 4963
unless ref $args->{$key} eq "ARRAY" and @{$args->{$key};} 0 0 0
Condition33%2/6
ref $args->{$key} eq "ARRAY" and @{$args->{$key};}
!ll&&!rl&&r
359301370
ref $args->{$key} eq "ARRAY" and @{$args->{$key};}
!ll&&!rl&&r
000
MC/DC50%1/2
ref $args->{$key} eq "ARRAY" and @{$args->{$key};}
ref $args->{$key} eq "ARRAY" @{$args->{$key};}
MC/DC0%0/2
ref $args->{$key} eq "ARRAY" and @{$args->{$key};}
ref $args->{$key} eq "ARRAY" @{$args->{$key};}
Truth table66%2/3
A and B
A= ref $args->{$key} eq "ARRAY"B= @{$args->{$key};}
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= ref $args->{$key} eq "ARRAY"B= @{$args->{$key};}
ABresult
0X0
100
111
945 0 require JSON::XS;
946 0 my @values = @{$args->{$key}};
947 push @details, "$key=" . join (" ", map {
948 0 ▶ JSON::XS::encode_json (substr $_, 0, 80) . (length $_ > 80 ? "..." : "")
Branch: 6 branches
BranchTrueFalseTotal
length $_ > 80 ? : 34 2656 2690
$#values < 3 ? : 1354 16 1370
@values > 4 ? : 4 1366 1370
length $_ > 80 ? : 0 0 0
$#values < 3 ? : 0 0 0
@values > 4 ? : 0 0 0
949 } @values[0 .. ($#values < 3 ? $#values : 3)])
950 . (@values > 4 ? " ..." : "");
951 }
952 0 ▶ if ($req->{tool} eq "grep" && defined $args->{pattern} && !ref $args->{pattern}) {
Branch: 2 branches
BranchTrueFalseTotal
if ($req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}) 13 3768 3781
if ($req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}) 0 0 0
Condition33%4/12
$req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}
!ll&&!rl&&r
3768013
$req->{"tool"} eq "grep" and defined $args->{"pattern"}
!ll&&!rl&&r
3768013
$req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}
!ll&&!rl&&r
000
$req->{"tool"} eq "grep" and defined $args->{"pattern"}
!ll&&!rl&&r
000
MC/DC33%1/3
$req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}
$req->{"tool"} eq "grep" defined $args->{"pattern"} not ref $args->{"pattern"}
MC/DC0%0/3
$req->{"tool"} eq "grep" and defined $args->{"pattern"} and not ref $args->{"pattern"}
$req->{"tool"} eq "grep" defined $args->{"pattern"} not ref $args->{"pattern"}
Truth table50%2/4
A and B and not(C)
A= $req->{"tool"} eq "grep"B= defined $args->{"pattern"}C= not ref $args->{"pattern"}
ABCresult
0XX0
10X0
1100
1111
Truth table0%0/4
A and B and not(C)
A= $req->{"tool"} eq "grep"B= defined $args->{"pattern"}C= not ref $args->{"pattern"}
ABCresult
0XX0
10X0
1100
1111
953 0 require JSON::XS;
954 push @details, "pattern=" . JSON::XS::encode_json (substr $args->{pattern}, 0, 160)
955 0 ▶ . (length $args->{pattern} > 160 ? "..." : "");
Branch: 2 branches
BranchTrueFalseTotal
length $args->{'pattern'} > 160 ? : 0 13 13
length $args->{'pattern'} > 160 ? : 0 0 0
956 }
957 push @details, "name=" . (substr $args->{name}, 0, 160)
958 0 ▶ if $req->{tool} eq "call-tool" && defined $args->{name} && !ref $args->{name};
Branch: 2 branches
BranchTrueFalseTotal
if $req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"} 8 3773 3781
if $req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"} 0 0 0
Condition33%4/12
$req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"}
!ll&&!rl&&r
377308
$req->{"tool"} eq "call-tool" and defined $args->{"name"}
!ll&&!rl&&r
377308
$req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"}
!ll&&!rl&&r
000
$req->{"tool"} eq "call-tool" and defined $args->{"name"}
!ll&&!rl&&r
000
MC/DC33%1/3
$req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"}
$req->{"tool"} eq "call-tool" defined $args->{"name"} not ref $args->{"name"}
MC/DC0%0/3
$req->{"tool"} eq "call-tool" and defined $args->{"name"} and not ref $args->{"name"}
$req->{"tool"} eq "call-tool" defined $args->{"name"} not ref $args->{"name"}
Truth table50%2/4
A and B and not(C)
A= $req->{"tool"} eq "call-tool"B= defined $args->{"name"}C= not ref $args->{"name"}
ABCresult
0XX0
10X0
1100
1111
Truth table0%0/4
A and B and not(C)
A= $req->{"tool"} eq "call-tool"B= defined $args->{"name"}C= not ref $args->{"name"}
ABCresult
0XX0
10X0
1100
1111
959 0 ▶ if ($req->{tool} eq "ex" && defined $args->{command} && !ref $args->{command}) {
Branch: 2 branches
BranchTrueFalseTotal
if ($req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}) 18 3763 3781
if ($req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}) 0 0 0
Condition41%5/12
$req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}
!ll&&!rl&&r
3762118
$req->{"tool"} eq "ex" and defined $args->{"command"}
!ll&&!rl&&r
3762019
$req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}
!ll&&!rl&&r
000
$req->{"tool"} eq "ex" and defined $args->{"command"}
!ll&&!rl&&r
000
MC/DC66%2/3
$req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}
$req->{"tool"} eq "ex" defined $args->{"command"} not ref $args->{"command"}
MC/DC0%0/3
$req->{"tool"} eq "ex" and defined $args->{"command"} and not ref $args->{"command"}
$req->{"tool"} eq "ex" defined $args->{"command"} not ref $args->{"command"}
Truth table75%3/4
A and B and not(C)
A= $req->{"tool"} eq "ex"B= defined $args->{"command"}C= not ref $args->{"command"}
ABCresult
0XX0
10X0
1100
1111
Truth table0%0/4
A and B and not(C)
A= $req->{"tool"} eq "ex"B= defined $args->{"command"}C= not ref $args->{"command"}
ABCresult
0XX0
10X0
1100
1111
960 0 require JSON::XS;
961 push @details, "command=" . JSON::XS::encode_json (substr $args->{command}, 0, 200)
962 0 ▶ . (length $args->{command} > 200 ? "..." : "");
Branch: 2 branches
BranchTrueFalseTotal
length $args->{'command'} > 200 ? : 0 18 18
length $args->{'command'} > 200 ? : 0 0 0
963 }
964 0 ▶ if ($req->{tool} eq "path-op") {
Branch: 2 branches
BranchTrueFalseTotal
if ($req->{"tool"} eq "path-op") 679 3102 3781
if ($req->{"tool"} eq "path-op") 0 0 0
965 push @details, map {
966 0 ($_ eq "unlink" || $_ eq "rmdir")
967 ? ($args->{$_} ? $_ : ())
968 : (defined $args->{$_} && !ref $args->{$_}
969 0 ▶ ? "$_=" . (substr $args->{$_}, 0, 80) : ())
Branch: 6 branches
BranchTrueFalseTotal
$_ eq 'unlink' || $_ eq 'rmdir' ? : 1358 4074 5432
$args->{$_} ? : 118 1240 1358
defined $args->{$_} && !ref($args->{$_}) ? : 641 3433 4074
$_ eq 'unlink' || $_ eq 'rmdir' ? : 0 0 0
$args->{$_} ? : 0 0 0
defined $args->{$_} && !ref($args->{$_}) ? : 0 0 0
Condition41%5/12
$_ eq "unlink" or $_ eq "rmdir"
l!l&&r!l&&!r
6796794074
defined $args->{$_} and not ref $args->{$_}
!ll&&!rl&&r
34330641
$_ eq "unlink" or $_ eq "rmdir"
l!l&&r!l&&!r
000
defined $args->{$_} and not ref $args->{$_}
!ll&&!rl&&r
000
MC/DC100%2/2
$_ eq "unlink" or $_ eq "rmdir"
$_ eq "unlink" $_ eq "rmdir"
MC/DC50%1/2
defined $args->{$_} and not ref $args->{$_}
defined $args->{$_} not ref $args->{$_}
MC/DC0%0/2
$_ eq "unlink" or $_ eq "rmdir"
$_ eq "unlink" $_ eq "rmdir"
MC/DC0%0/2
defined $args->{$_} and not ref $args->{$_}
defined $args->{$_} not ref $args->{$_}
Truth table100%3/3
A or B
A= $_ eq "unlink"B= $_ eq "rmdir"
ABresult
1X1
011
000
Truth table66%2/3
A and not(B)
A= defined $args->{$_}B= not ref $args->{$_}
ABresult
0X0
100
111
Truth table0%0/3
A or B
A= $_ eq "unlink"B= $_ eq "rmdir"
ABresult
1X1
011
000
Truth table0%0/3
A and not(B)
A= defined $args->{$_}B= not ref $args->{$_}
ABresult
0X0
100
111
970 } qw(unlink rmdir mkpath mkdir symlink truncate chmod rename);
971 }
972 0 for my $key (sort keys %extra) {
973 0 ▶ next unless defined $extra{$key} && !ref $extra{$key};
Branch: 2 branches
BranchTrueFalseTotal
unless defined $extra{$key} and not ref $extra{$key} 0 28 28
unless defined $extra{$key} and not ref $extra{$key} 0 0 0
Condition16%1/6
defined $extra{$key} and not ref $extra{$key}
!ll&&!rl&&r
0028
defined $extra{$key} and not ref $extra{$key}
!ll&&!rl&&r
000
MC/DC0%0/2
defined $extra{$key} and not ref $extra{$key}
defined $extra{$key} not ref $extra{$key}
MC/DC0%0/2
defined $extra{$key} and not ref $extra{$key}
defined $extra{$key} not ref $extra{$key}
Truth table33%1/3
A and not(B)
A= defined $extra{$key}B= not ref $extra{$key}
ABresult
0X0
100
111
Truth table0%0/3
A and not(B)
A= defined $extra{$key}B= not ref $extra{$key}
ABresult
0X0
100
111
974 0 push @details, "$key=" . (substr $extra{$key}, 0, 160);
975 }
976  
977 0 (my $message = join " ", $req->{tool}, @details) =~ s/[\r\n]/ /g;
978 0 mcp_log $message;
979  
980 0 my $reply = $req->{on_reply};
981 3677 ▶ $req->{on_reply} = sub {
Subroutine __ANON__: called CC=5 SCAR=24.3
982 0 ▶ my ($req, $result) = @_;
Subroutine __ANON__: not called CC=5 SCAR=24.3
983  
984 0 ▶ if ($result->{isError}) {
Branch: 2 branches
BranchTrueFalseTotal
if ($result->{"isError"}) 589 3088 3677
if ($result->{"isError"}) 0 0 0
985 my $message = ref $result->{content} eq "ARRAY"
986 && ref $result->{content}[0] eq "HASH"
987 0 ▶ ? $result->{content}[0]{text} // "unknown error" : "unknown error";
Branch: 2 branches
BranchTrueFalseTotal
ref $result->{'content'} eq 'ARRAY' && ref $result->{'content'}[0] eq 'HASH' ? : 589 0 589
ref $result->{'content'} eq 'ARRAY' && ref $result->{'content'}[0] eq 'HASH' ? : 0 0 0
Condition20%2/10
ref $result->{"content"} eq "ARRAY" and ref $result->{"content"}[0] eq "HASH"
!ll&&!rl&&r
00589
$result->{"content"}[0]{"text"} // "unknown error"
l!l
5890
ref $result->{"content"} eq "ARRAY" and ref $result->{"content"}[0] eq "HASH"
!ll&&!rl&&r
000
$result->{"content"}[0]{"text"} // "unknown error"
l!l
00
MC/DC0%0/2
ref $result->{"content"} eq "ARRAY" and ref $result->{"content"}[0] eq "HASH"
ref $result->{"content"} eq "ARRAY" ref $result->{"content"}[0] eq "HASH"
MC/DC0%0/1
$result->{"content"}[0]{"text"} // "unknown error"
$result->{"content"}[0]{"text"}
MC/DC0%0/2
ref $result->{"content"} eq "ARRAY" and ref $result->{"content"}[0] eq "HASH"
ref $result->{"content"} eq "ARRAY" ref $result->{"content"}[0] eq "HASH"
MC/DC0%0/1
$result->{"content"}[0]{"text"} // "unknown error"
$result->{"content"}[0]{"text"}
Truth table33%1/3
A and B
A= ref $result->{"content"} eq "ARRAY"B= ref $result->{"content"}[0] eq "HASH"
ABresult
0X0
100
111
Truth table50%1/2
A
A= $result->{"content"}[0]{"text"}
Aresult
11
00
Truth table0%0/3
A and B
A= ref $result->{"content"} eq "ARRAY"B= ref $result->{"content"}[0] eq "HASH"
ABresult
0X0
100
111
Truth table0%0/2
A
A= $result->{"content"}[0]{"text"}
Aresult
11
00
988 0 $message =~ s/\n.*//s;
989 0 mcp_log "$req->{tool} failed: " . (substr $message, 0, 240);
990 }
991 0 $reply->(@_);
992 0 };
993 }
994  
995 266 ▶sub _mcp_log_init {
Subroutine _mcp_log_init: called CC=1 SCAR=0.8
996 0 ▶ my ($name, $silent) = @_;
Subroutine _mcp_log_init: not called CC=1 SCAR=0.8
997  
998 0 $quiet = $silent;
999 0 my $identity = AnyEvent::MCP::Config::program_name () . "/$name" . "[$$]";
1000  
1001 296 ▶ no warnings 'redefine';
Subroutine BEGIN: called CC=1 SCAR=0.0
1002 310 ▶ *AnyEvent::Log::default_format = sub ($$$$) {
Subroutine __ANON__: called CC=2 SCAR=9.2
1003 0 ▶ my ($when, $ctx, $level, $message) = @_;
Subroutine __ANON__: not called CC=2 SCAR=9.2
1004 0 my $stamp = substr +(AnyEvent::Log::format_time $when), 8, 14;
1005 0 ▶ my $source = $ctx == $AnyEvent::Log::LOG ? "" : "$AnyEvent::Log::LEVEL2STR[$level] $ctx->[0]: ";
Branch: 2 branches
BranchTrueFalseTotal
$ctx == $AnyEvent::Log::LOG ? : 221 89 310
$ctx == $AnyEvent::Log::LOG ? : 0 0 0
1006 0 join "", map "$stamp $identity $source$_\n", split /\n/, $message;
1007 0 };
1008 }
1009  
1010 217 ▶sub mcp_config {
Subroutine mcp_config: called CC=2 SCAR=9.2
Pod documented
1011 0 ▶ my %kv = @_;
Subroutine mcp_config: not called CC=2 SCAR=9.2
Pod documented
1012  
1013 $kv{instructions} = AnyEvent::MCP::_clean_text $kv{instructions}
1014 0 ▶ if exists $kv{instructions};
Branch: 2 branches
BranchTrueFalseTotal
if exists $kv{"instructions"} 202 15 217
if exists $kv{"instructions"} 0 0 0
1015  
1016 0 %config = (%config, %kv);
1017 }
1018  
1019 1859 ▶sub mcp_tool {
Subroutine mcp_tool: called CC=1 SCAR=1.2
Pod documented
1020 0 ▶ $toolset->tool (@_)
Subroutine mcp_tool: not called CC=1 SCAR=1.2
Pod documented
1021 }
1022  
1023 # format a JSON Schema type for command-line tool help.
1024 192 ▶sub _tool_type {
Subroutine _tool_type: called CC=7 SCAR=28.0
1025 0 ▶ my ($schema) = @_;
Subroutine _tool_type: not called CC=7 SCAR=28.0
1026 0 ▶ return "any" unless ref $schema eq "HASH";
Branch: 2 branches
BranchTrueFalseTotal
unless ref $schema eq "HASH" 0 192 192
unless ref $schema eq "HASH" 0 0 0
1027 0 for my $key (qw(anyOf oneOf)) {
1028 0 return join "|", map _tool_type ($_), @{$schema->{$key}}
1029 0 ▶ if ref $schema->{$key} eq "ARRAY";
Branch: 2 branches
BranchTrueFalseTotal
if ref $schema->{$key} eq "ARRAY" 15 354 369
if ref $schema->{$key} eq "ARRAY" 0 0 0
1030 }
1031 0 ▶ my $type = $schema->{type} // "any";
Condition25%1/4
$schema->{"type"} // "any"
l!l
1770
$schema->{"type"} // "any"
l!l
00
MC/DC0%0/1
$schema->{"type"} // "any"
$schema->{"type"}
MC/DC0%0/1
$schema->{"type"} // "any"
$schema->{"type"}
Truth table50%1/2
A
A= $schema->{"type"}
Aresult
11
00
Truth table0%0/2
A
A= $schema->{"type"}
Aresult
11
00
1032 0 ▶ $type = join "|", @$type if ref $type eq "ARRAY";
Branch: 2 branches
BranchTrueFalseTotal
if ref $type eq "ARRAY" 0 177 177
if ref $type eq "ARRAY" 0 0 0
1033 0 ▶ $type = "array[" . _tool_type ($schema->{items}) . "]" if $type eq "array";
Branch: 2 branches
BranchTrueFalseTotal
if $type eq "array" 10 167 177
if $type eq "array" 0 0 0
1034 0 $type
1035 }
1036  
1037 470 ▶sub mcp_tool_help {
Subroutine mcp_tool_help: called CC=16 SCAR=40.5
Pod documented
1038 0 ▶ my ($enabled, @toolsets) = @_;
Subroutine mcp_tool_help: not called CC=16 SCAR=40.5
Pod documented
1039 0 ▶ return unless $enabled;
Branch: 2 branches
BranchTrueFalseTotal
unless $enabled 465 5 470
unless $enabled 0 0 0
1040  
1041 0 my $json = AnyEvent::MCP::json_class ()->new->canonical;
1042 0 my @tools = map @{$_->list}, @toolsets;
1043 0 for my $tool (@tools) {
1044 0 print "$tool->{name}\n";
1045 0 ▶ (my $description = $tool->{description} // "") =~ s/\n/\n /g;
Condition25%1/4
$tool->{"description"} // ""
l!l
350
$tool->{"description"} // ""
l!l
00
MC/DC0%0/1
$tool->{"description"} // ""
$tool->{"description"}
MC/DC0%0/1
$tool->{"description"} // ""
$tool->{"description"}
Truth table50%1/2
A
A= $tool->{"description"}
Aresult
11
00
Truth table0%0/2
A
A= $tool->{"description"}
Aresult
11
00
1046 0 ▶ print " $description\n" if length $description;
Branch: 2 branches
BranchTrueFalseTotal
if length $description 35 0 35
if length $description 0 0 0
1047  
1048 0 ▶ my $schema = $tool->{inputSchema} || {};
Condition25%1/4
$tool->{'inputSchema'} || {}
l!l
350
$tool->{'inputSchema'} || {}
l!l
00
MC/DC0%0/1
$tool->{'inputSchema'} || {}
$tool->{'inputSchema'}
MC/DC0%0/1
$tool->{'inputSchema'} || {}
$tool->{'inputSchema'}
Truth table50%1/2
A
A= $tool->{'inputSchema'}
Aresult
11
00
Truth table0%0/2
A
A= $tool->{'inputSchema'}
Aresult
11
00
1049 0 ▶ my $properties = $schema->{properties} || {};
Condition25%1/4
$schema->{'properties'} || {}
l!l
350
$schema->{'properties'} || {}
l!l
00
MC/DC0%0/1
$schema->{'properties'} || {}
$schema->{'properties'}
MC/DC0%0/1
$schema->{'properties'} || {}
$schema->{'properties'}
Truth table50%1/2
A
A= $schema->{'properties'}
Aresult
11
00
Truth table0%0/2
A
A= $schema->{'properties'}
Aresult
11
00
1050 0 ▶ my %required = map { $_ => 1 } @{$schema->{required} || []};
Condition50%2/4
$schema->{'required'} || []
l!l
296
$schema->{'required'} || []
l!l
00
MC/DC100%1/1
$schema->{'required'} || []
$schema->{'required'}
MC/DC0%0/1
$schema->{'required'} || []
$schema->{'required'}
Truth table100%2/2
A
A= $schema->{'required'}
Aresult
11
00
Truth table0%0/2
A
A= $schema->{'required'}
Aresult
11
00
1051 0 for my $name (sort keys %$properties) {
1052 0 my $property = $properties->{$name};
1053 0 my $type = _tool_type ($property);
1054 0 ▶ my $status = $required{$name} ? "required" : "optional";
Branch: 2 branches
BranchTrueFalseTotal
$required{$name} ? : 61 91 152
$required{$name} ? : 0 0 0
1055 0 my @extras;
1056 push @extras, "default: " . $json->encode ($property->{default})
1057 0 ▶ if exists $property->{default};
Branch: 2 branches
BranchTrueFalseTotal
if exists $property->{"default"} 34 118 152
if exists $property->{"default"} 0 0 0
1058 0 push @extras, "values: " . join (", ", @{$property->{enum}})
1059 0 ▶ if ref $property->{enum} eq "ARRAY";
Branch: 2 branches
BranchTrueFalseTotal
if ref $property->{"enum"} eq "ARRAY" 7 145 152
if ref $property->{"enum"} eq "ARRAY" 0 0 0
1060 0 ▶ print " $name $type $status", (@extras ? " (" . join ("; ", @extras) . ")" : ""), "\n";
Branch: 2 branches
BranchTrueFalseTotal
@extras ? : 38 114 152
@extras ? : 0 0 0
1061 0 ▶ if (length ($property->{description} // "")) {
Branch: 2 branches
BranchTrueFalseTotal
if (length($property->{"description"} // "")) 100 52 152
if (length($property->{"description"} // "")) 0 0 0
Condition50%2/4
$property->{"description"} // ""
l!l
10052
$property->{"description"} // ""
l!l
00
MC/DC100%1/1
$property->{"description"} // ""
$property->{"description"}
MC/DC0%0/1
$property->{"description"} // ""
$property->{"description"}
Truth table100%2/2
A
A= $property->{"description"}
Aresult
11
00
Truth table0%0/2
A
A= $property->{"description"}
Aresult
11
00
1062 0 (my $detail = $property->{description}) =~ s/\n/\n /g;
1063 0 print " $detail\n";
1064 }
1065 }
1066 0 print "\n";
1067 }
1068 0 ▶ print "No tools registered.\n" unless @tools;
Branch: 2 branches
BranchTrueFalseTotal
unless @tools 0 5 5
unless @tools 0 0 0
1069 0 exit;
1070 }
1071  
1072 127 ▶sub _mcp_help_row {
Subroutine _mcp_help_row: called CC=7 SCAR=25.7
1073 0 ▶ my ($option, $description) = @_;
Subroutine _mcp_help_row: not called CC=7 SCAR=25.7
1074  
1075 0 my $start = " $option";
1076 0 my $margin = " " x 34;
1077 0 ▶ my $out = length $start < 34 ? "" : "$start\n";
Branch: 2 branches
BranchTrueFalseTotal
length $start < 34 ? : 106 21 127
length $start < 34 ? : 0 0 0
1078 0 ▶ my $line = length $start < 34 ? $start . (substr $margin, length $start) : $margin;
Branch: 2 branches
BranchTrueFalseTotal
length $start < 34 ? : 106 21 127
length $start < 34 ? : 0 0 0
1079  
1080 0 for my $word (split /\s+/, $description) {
1081 0 ▶ if (length $line > 34 && (length $line) + 1 + length $word > 79) {
Branch: 2 branches
BranchTrueFalseTotal
if (length $line > 34 and length($line) + 1 + length($word) > 79) 102 834 936
if (length $line > 34 and length($line) + 1 + length($word) > 79) 0 0 0
Condition50%3/6
length $line > 34 and length($line) + 1 + length($word) > 79
!ll&&!rl&&r
127707102
length $line > 34 and length($line) + 1 + length($word) > 79
!ll&&!rl&&r
000
MC/DC100%2/2
length $line > 34 and length($line) + 1 + length($word) > 79
length $line > 34 length($line) + 1 + length($word) > 79
MC/DC0%0/2
length $line > 34 and length($line) + 1 + length($word) > 79
length $line > 34 length($line) + 1 + length($word) > 79
Truth table100%3/3
A and B
A= length $line > 34B= length($line) + 1 + length($word) > 79
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= length $line > 34B= length($line) + 1 + length($word) > 79
ABresult
0X0
100
111
1082 0 $out .= "$line\n";
1083 0 $line = $margin;
1084 }
1085  
1086 0 ▶ $line .= " " if length $line > 34;
Branch: 2 branches
BranchTrueFalseTotal
if length $line > 34 707 229 936
if length $line > 34 0 0 0
1087 0 $line .= $word;
1088 }
1089  
1090 "$out$line\n"
1091 0 }
1092  
1093 7 ▶sub _mcp_help {
Subroutine _mcp_help: called CC=13 SCAR=39.9
1094 0 ▶ my ($usage, $description, $options, $option_heading, $examples) = @_;
Subroutine _mcp_help: not called CC=13 SCAR=39.9
1095  
1096 0 $usage =~ s/\n*\z/\n/;
1097 0 my $help = $usage;
1098 0 ▶ $help .= "\n$description\n" if defined $description && length $description;
Branch: 2 branches
BranchTrueFalseTotal
if defined $description and length $description 7 0 7
if defined $description and length $description 0 0 0
Condition16%1/6
defined $description and length $description
!ll&&!rl&&r
007
defined $description and length $description
!ll&&!rl&&r
000
MC/DC0%0/2
defined $description and length $description
defined $description length $description
MC/DC0%0/2
defined $description and length $description
defined $description length $description
Truth table33%1/3
A and B
A= defined $descriptionB= length $description
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= defined $descriptionB= length $description
ABresult
0X0
100
111
1099  
1100 0 $help .= "\nCommon options:\n";
1101 0 my @common = (
1102 ["--name NAME", "Select named configuration (instance defaults to 'default')"],
1103 ["--bind ADDRESS[:PORT]", "Override the HTTP listen address or port"],
1104 ["--tls-cert FILE", "PEM certificate (and optionally key) for HTTPS"],
1105 ["--tls-key FILE", "PEM private key (or combined key/certificate PEM)"],
1106 ["--token TOKEN", "Set an accepted token (repeatable; replaces defaults)"],
1107 ["-s, --set KEY=VALUE", "Override a trusted instance setting (repeatable)"],
1108 ["--stdio", "Serve MCP on stdin/stdout; other listeners may remain"],
1109 ["--connect URL", "Connect to a multibroker at http[s]://host:port/token/alias"],
1110 ["--custom-instructions TEXT", "Describe when this server instance should be used"],
1111 ["--auto-allow TOOL[,ACTION[,CAPABILITY]]", "Add an ordered automatic allow rule (repeatable)"],
1112 ["--auto-deny TOOL[,ACTION[,CAPABILITY]]", "Add an ordered automatic deny rule (repeatable)"],
1113 ["--quiet", "Suppress routine tool activity and tool-failure logging"],
1114 ["--print-url[=USER] (--print-urls)", "Print enabled user URLs, or one exact user"],
1115 ["--tool-help", "Print registered tool descriptions and arguments, then exit"],
1116 ["--help", "Display this help and exit"],
1117 );
1118 0 $help .= _mcp_help_row (@$_) for @common;
1119  
1120 0 ▶ if ($options && @$options) {
Branch: 2 branches
BranchTrueFalseTotal
if ($options and @$options) 7 0 7
if ($options and @$options) 0 0 0
Condition16%1/6
$options and @$options
!ll&&!rl&&r
007
$options and @$options
!ll&&!rl&&r
000
MC/DC0%0/2
$options and @$options
$options @$options
MC/DC0%0/2
$options and @$options
$options @$options
Truth table33%1/3
A and B
A= $optionsB= @$options
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= $optionsB= @$options
ABresult
0X0
100
111
1121 0 ▶ $help .= "\n" . ($option_heading // "Application options:") . "\n"
Branch: 2 branches
BranchTrueFalseTotal
if ref $options->[0] 5 2 7
if ref $options->[0] 0 0 0
Condition50%2/4
$option_heading // "Application options:"
l!l
14
$option_heading // "Application options:"
l!l
00
MC/DC100%1/1
$option_heading // "Application options:"
$option_heading
MC/DC0%0/1
$option_heading // "Application options:"
$option_heading
Truth table100%2/2
A
A= $option_heading
Aresult
11
00
Truth table0%0/2
A
A= $option_heading
Aresult
11
00
1122 if ref $options->[0];
1123 0 for my $option (@$options) {
1124 0 ▶ if (ref $option) {
Branch: 2 branches
BranchTrueFalseTotal
if (ref $option) { } 22 4 26
if (ref $option) { } 0 0 0
1125 0 $help .= _mcp_help_row (@$option);
1126 } else {
1127 0 ▶ $help .= "\n" unless $help =~ /\n\n\z/;
Branch: 2 branches
BranchTrueFalseTotal
unless $help =~ /\n\n\z/u 4 0 4
unless $help =~ /\n\n\z/u 0 0 0
1128 0 $help .= "$option\n";
1129 }
1130 }
1131 }
1132 0 ▶ $help .= "\nExamples:\n$examples\n"
Branch: 2 branches
BranchTrueFalseTotal
if defined $examples and length $examples 7 0 7
if defined $examples and length $examples 0 0 0
Condition16%1/6
defined $examples and length $examples
!ll&&!rl&&r
007
defined $examples and length $examples
!ll&&!rl&&r
000
MC/DC0%0/2
defined $examples and length $examples
defined $examples length $examples
MC/DC0%0/2
defined $examples and length $examples
defined $examples length $examples
Truth table33%1/3
A and B
A= defined $examplesB= length $examples
ABresult
0X0
100
111
Truth table0%0/3
A and B
A= defined $examplesB= length $examples
ABresult
0X0
100
111
1133 if defined $examples && length $examples;
1134 0 $help .= "\nNamed users and URLs:\n"
1135 . " anyevent-mcp create-user chatgpt\n"
1136 . " $0 --print-urls # list URLs for all enabled users\n"
1137 . " $0 --print-url=chatgpt # select one user\n"
1138 . "A URL marked (connect) is the one used for browser, Vim, or reverse connections.\n"
1139 . "Users inherit from global, program, then instance; server restart is needed\n"
1140 . "after changing user definitions.\n";
1141  
1142 0 $help
1143 }
1144  
1145 275 ▶sub mcp_getoptions {
Subroutine mcp_getoptions: called CC=46 SCAR=60.8
Pod documented
1146 0 ▶ require Getopt::Long;
Subroutine mcp_getoptions: not called CC=46 SCAR=60.8
Pod documented
1147 0 require AnyEvent::MCP::Config;
1148  
1149 0 ▶ my %settings = %{ref $_[0] eq "HASH" ? shift : {}};
Branch: 2 branches
BranchTrueFalseTotal
ref $_[0] eq 'HASH' ? : 272 3 275
ref $_[0] eq 'HASH' ? : 0 0 0
1150 my $usage = delete $settings{usage}
1151 0 ▶ // "Usage: $0 [OPTION]... [ARG]...\n";
Condition50%2/4
delete $settings{"usage"} // "Usage: $0 [OPTION]... [ARG]...\n"
l!l
2705
delete $settings{"usage"} // "Usage: $0 [OPTION]... [ARG]...\n"
l!l
00
MC/DC100%1/1
delete $settings{"usage"} // "Usage: $0 [OPTION]... [ARG]...\n"
delete $settings{"usage"}
MC/DC0%0/1
delete $settings{"usage"} // "Usage: $0 [OPTION]... [ARG]...\n"
delete $settings{"usage"}
Truth table100%2/2
A
A= delete $settings{"usage"}
Aresult
11
00
Truth table0%0/2
A
A= delete $settings{"usage"}
Aresult
11
00
1152 0 my @help = delete @settings{qw(description options option_heading examples)};
1153 0 my %url = (%config, %settings);
1154 0 delete @url{qw(name bind stdio)};
1155 0 my @auto_rules;
1156 my %set;
1157  
1158 Getopt::Long::GetOptions (
1159 AnyEvent::MCP::Config::http_getopt (\my $name, \my $bind, \my $print_url, \my @tokens),
1160 "tls-cert=s" => \my $tls_cert,
1161 "tls-key=s" => \my $tls_key,
1162 "stdio" => \my $stdio,
1163 "connect=s" => \my $connect,
1164 "custom-instructions=s" => \my $custom_instructions,
1165 28 ▶ "auto-allow=s" => sub { push @auto_rules, ["allow", $_[1]] },
Subroutine __ANON__: called CC=1 SCAR=0.0
1166 2 ▶ "auto-deny=s" => sub { push @auto_rules, ["deny", $_[1]] },
Subroutine __ANON__: called CC=1 SCAR=0.0
1167 12 ▶ "set|s=s" => sub {
Subroutine __ANON__: called CC=2 SCAR=7.1
1168 12 my ($key, $value) = $_[1] =~ /\A([^\s=]+)=(.*)\z/;
1169 12 ▶ defined $value or die "Invalid --set KEY=VALUE\n";
Branch: 1 branch
BranchTrueFalseTotal
defined $value or die "Invalid --set KEY=VALUE\n" 12 0 12
1170 12 $set{$key} = $value;
1171 },
1172 0 ▶ "tool-help" => \my $tool_help,
Branch: 2 branches
BranchTrueFalseTotal
Getopt::Long::GetOptions(AnyEvent::MCP::Config::http_getopt(\my $name, \my $bind, \my $print_url, \my @tokens), "tls-cert=s", \my $tls_cert, "tls-key=s", \my $tls_key, "stdio", \my $stdio, "connect=s", \my $connect, "custom-instructions=s", \my $custom_instructions, "auto-allow=s", sub { push @auto_rules, ["allow", $_[1]]; } , "auto-deny=s", sub { push @auto_rules, ["deny", $_[1]]; } , "set|s=s", sub { my($key, $value) = $_[1] =~ /\A([^\s=]+)=(.*)\z/u; defined $value or die "Invalid --set KEY=VALUE\n"; $set{$key} = $value; } , "tool-help", \my $tool_help, "quiet", \my $silent, "help", \my $help, @_) or die $usage 273 2 275
&Getopt::Long::GetOptions(AnyEvent::MCP::Config::http_getopt(\my $name, \my $bind, \my $print_url, \my @tokens), "tls-cert=s", \my $tls_cert, "tls-key=s", \my $tls_key, "stdio", \my $stdio, "connect=s", \my $connect, "custom-instructions=s", \my $custom_instructions, "auto-allow=s", sub { push @auto_rules, ["allow", $_[1]]; } , "auto-deny=s", sub { push @auto_rules, ["deny", $_[1]]; } , "set|s=s", sub { my($key, $value) = $_[1] =~ /\A([^\s=]+)=(.*)\z/u; defined $value or die "Invalid --set KEY=VALUE\n"; $set{$key} = $value; } , "tool-help", \my $tool_help, "quiet", \my $silent, "help", \my $help, @_) or die $usage 0 0 0
1173 "quiet" => \my $silent,
1174 "help" => \my $help,
1175 @_,
1176 ) or die $usage;
1177  
1178 0 ▶ if ($help) {
Branch: 2 branches
BranchTrueFalseTotal
if ($help) 7 266 273
if ($help) 0 0 0
1179 0 print _mcp_help $usage, @help;
1180 0 exit;
1181 }
1182  
1183 0 ▶ $name = AnyEvent::MCP::Config::server_name ($name // $settings{name} // $config{name});
Condition41%5/12
($name // $settings{"name"}) // $config{"name"}
l!l&&r!l&&!r
560210
$name // $settings{"name"}
l!l&&r!l&&!r
551210
($name // $settings{"name"}) // $config{"name"}
l!l&&r!l&&!r
000
$name // $settings{"name"}
l!l&&r!l&&!r
000
MC/DC66%2/3
($name // $settings{"name"}) // $config{"name"}
$name $settings{"name"} $config{"name"}
MC/DC0%0/3
($name // $settings{"name"}) // $config{"name"}
$name $settings{"name"} $config{"name"}
Truth table75%3/4
A // B // C
A= $nameB= $settings{"name"}C= $config{"name"}
ABCresult
1XX1
01X1
0011
0000
Truth table0%0/4
A // B // C
A= $nameB= $settings{"name"}C= $config{"name"}
ABCresult
1XX1
01X1
0011
0000
1184 0 ▶ if (%set) {
Branch: 2 branches
BranchTrueFalseTotal
if (%set) 3 263 266
if (%set) 0 0 0
1185 0 ▶ my $instance = AnyEvent::MCP::Config->global->{section}{"instance $name"} ||= {};
Condition25%1/4
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"} ||= {}
l!l
30
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"} ||= {}
l!l
00
MC/DC0%0/1
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"} ||= {}
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"}
MC/DC0%0/1
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"} ||= {}
"AnyEvent::MCP::Config"->global->{"section"}{"instance $name"}
Truth table50%1/2
A
A= "AnyEvent::MCP::Config"->global->{"section"}{"instance $name"}
Aresult
11
00
Truth table0%0/2
A
A= "AnyEvent::MCP::Config"->global->{"section"}{"instance $name"}
Aresult
11
00
1186 0 %$instance = (%$instance, %set);
1187 }
1188  
1189 0 _mcp_log_init ($name, $silent);
1190 0 ▶ my %server = (
Branch: 18 branches
BranchTrueFalseTotal
defined $bind ? : 21 245 266
defined $tls_cert ? : 1 265 266
defined $tls_key ? : 1 265 266
@tokens ? : 8 258 266
$stdio ? : 193 73 266
defined $connect ? : 3 263 266
defined $custom_instructions ? : 1 265 266
@auto_rules ? : 28 238 266
$tool_help ? : 6 260 266
defined $bind ? : 0 0 0
defined $tls_cert ? : 0 0 0
defined $tls_key ? : 0 0 0
@tokens ? : 0 0 0
$stdio ? : 0 0 0
defined $connect ? : 0 0 0
defined $custom_instructions ? : 0 0 0
@auto_rules ? : 0 0 0
$tool_help ? : 0 0 0
1191 %settings,
1192 name => $name,
1193 (defined $bind ? (bind => $bind) : ()),
1194 (defined $tls_cert ? (tls_cert => $tls_cert) : ()),
1195 (defined $tls_key ? (tls_key => $tls_key) : ()),
1196 (@tokens ? (tokens => \@tokens) : ()),
1197 ($stdio ? (stdio => 1) : ()),
1198 (defined $connect ? (connect => $connect) : ()),
1199 (defined $custom_instructions ? (custom_instructions => $custom_instructions) : ()),
1200 (@auto_rules ? (auto_rules => \@auto_rules) : ()),
1201 ($tool_help ? (tool_help => 1) : ()),
1202 );
1203  
1204 0 ▶ if (defined $print_url) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $print_url) 19 247 266
if (defined $print_url) 0 0 0
1205 0 ▶ my %options = (
Branch: 6 branches
BranchTrueFalseTotal
defined $tls_cert ? : 0 19 19
defined $tls_key ? : 0 19 19
@tokens ? : 2 17 19
defined $tls_cert ? : 0 0 0
defined $tls_key ? : 0 0 0
@tokens ? : 0 0 0
1206 %url,
1207 (defined $tls_cert ? (tls_cert => $tls_cert) : ()),
1208 (defined $tls_key ? (tls_key => $tls_key) : ()),
1209 (@tokens ? (tokens => \@tokens) : ()),
1210 );
1211 0 my $global = AnyEvent::MCP::Config->global;
1212 $options{path} //= $global->{section}{"instance $name"}{path}
1213 0 ▶ // $global->{section}{"program " . AnyEvent::MCP::Config::program_name ()}{path} // "/";
Condition28%4/14
$options{"path"} //= ($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
l!l
163
($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
l!l
03
$global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}
l!l&&r!l&&!r
003
$options{"path"} //= ($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
l!l
00
($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
l!l
00
$global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}
l!l&&r!l&&!r
000
MC/DC100%1/1
$options{"path"} //= ($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
$options{"path"}
MC/DC0%0/1
$options{"path"} //= ($global->{"section"}{"instance $name"}{"path"} // $global->{"section"}{'program ' . AnyEvent::MCP::Config::program_name()}{"path"}) // "/"
$options{"path"}
Truth table100%2/2
A
A= $options{"path"}
Aresult
11
00
Truth table0%0/2
A
A= $options{"path"}
Aresult
11
00
1214 0 ▶ if (($options{auth} || "") eq "none") {
Branch: 2 branches
BranchTrueFalseTotal
if (($options{"auth"} || "") eq "none") 0 19 19
if (($options{"auth"} || "") eq "none") 0 0 0
Condition25%1/4
$options{'auth'} || ''
l!l
019
$options{'auth'} || ''
l!l
00
MC/DC0%0/1
$options{'auth'} || ''
$options{'auth'}
MC/DC0%0/1
$options{'auth'} || ''
$options{'auth'}
Truth table50%1/2
A
A= $options{'auth'}
Aresult
11
00
Truth table0%0/2
A
A= $options{'auth'}
Aresult
11
00
1215 0 ▶ !exists $options{tokens} or die "Cannot combine auth => none with tokens\n";
Branch: 2 branches
BranchTrueFalseTotal
exists $options{"tokens"} and die "Cannot combine auth => none with tokens\n" 0 0 0
exists $options{"tokens"} and die "Cannot combine auth => none with tokens\n" 0 0 0
1216 }
1217 0 ▶ my $selected_bind = defined $bind ? $bind : ($settings{bind} // $config{bind});
Branch: 2 branches
BranchTrueFalseTotal
defined $bind ? : 10 9 19
defined $bind ? : 0 0 0
Condition16%1/6
$settings{"bind"} // $config{"bind"}
l!l&&r!l&&!r
009
$settings{"bind"} // $config{"bind"}
l!l&&r!l&&!r
000
MC/DC0%0/2
$settings{"bind"} // $config{"bind"}
$settings{"bind"} $config{"bind"}
MC/DC0%0/2
$settings{"bind"} // $config{"bind"}
$settings{"bind"} $config{"bind"}
Truth table33%1/3
A // B
A= $settings{"bind"}B= $config{"bind"}
ABresult
1X1
011
000
Truth table0%0/3
A // B
A= $settings{"bind"}B= $config{"bind"}
ABresult
1X1
011
000
1218 0 my %http = ($global->http_settings ($name, $selected_bind), %options);
1219 my @schemes = defined $http{tls_cert} || defined $http{tls_key}
1220 0 ▶ ? ("https", "http") : ($http{url_scheme} || "http");
Branch: 2 branches
BranchTrueFalseTotal
defined $http{'tls_cert'} || defined $http{'tls_key'} ? : 0 17 17
defined $http{'tls_cert'} || defined $http{'tls_key'} ? : 0 0 0
Condition20%2/10
defined $http{"tls_cert"} or defined $http{"tls_key"}
l!l&&r!l&&!r
0017
$http{"url_scheme"} or "http"
l!l
017
defined $http{"tls_cert"} or defined $http{"tls_key"}
l!l&&r!l&&!r
000
$http{"url_scheme"} or "http"
l!l
00
MC/DC0%0/2
defined $http{"tls_cert"} or defined $http{"tls_key"}
defined $http{"tls_cert"} defined $http{"tls_key"}
MC/DC0%0/1
$http{"url_scheme"} or "http"
$http{"url_scheme"}
MC/DC0%0/2
defined $http{"tls_cert"} or defined $http{"tls_key"}
defined $http{"tls_cert"} defined $http{"tls_key"}
MC/DC0%0/1
$http{"url_scheme"} or "http"
$http{"url_scheme"}
Truth table33%1/3
A or B
A= defined $http{"tls_cert"}B= defined $http{"tls_key"}
ABresult
1X1
011
000
Truth table50%1/2
A
A= $http{"url_scheme"}
Aresult
11
00
Truth table0%0/3
A or B
A= defined $http{"tls_cert"}B= defined $http{"tls_key"}
ABresult
1X1
011
000
Truth table0%0/2
A
A= $http{"url_scheme"}
Aresult
11
00
1221 my $managed = ($http{auth} || "") ne "none"
1222 && !exists $options{tokens}
1223 && !exists $global->{section}{"instance $name"}{tokens}
1224 0 ▶ && !exists $global->{section}{"program " . AnyEvent::MCP::Config::program_name ()}{tokens};
Condition36%8/22
($http{'auth'} || '') ne 'none' && !exists $options{'tokens'} && !exists $global->{'section'}{"instance $name"}{'tokens'} && !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
!ll&&!rl&&r
7010
($http{"auth"} || "") ne "none" and not exists $options{"tokens"} and not exists $global->{"section"}{"instance $name"}{"tokens"}
!ll&&!rl&&r
2510
($http{"auth"} || "") ne "none" and not exists $options{"tokens"}
!ll&&!rl&&r
0215
$http{'auth'} || ''
l!l
017
($http{'auth'} || '') ne 'none' && !exists $options{'tokens'} && !exists $global->{'section'}{"instance $name"}{'tokens'} && !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
!ll&&!rl&&r
000
($http{"auth"} || "") ne "none" and not exists $options{"tokens"} and not exists $global->{"section"}{"instance $name"}{"tokens"}
!ll&&!rl&&r
000
($http{"auth"} || "") ne "none" and not exists $options{"tokens"}
!ll&&!rl&&r
000
$http{'auth'} || ''
l!l
00
MC/DC0%0/4
($http{'auth'} || '') ne 'none' && !exists $options{'tokens'} && !exists $global->{'section'}{"instance $name"}{'tokens'} && !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
$http{'auth'} not exists $options{"tokens"} not exists $global->{"section"}{"instance $name"}{"tokens"} !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
MC/DC0%0/4
($http{'auth'} || '') ne 'none' && !exists $options{'tokens'} && !exists $global->{'section'}{"instance $name"}{'tokens'} && !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
$http{'auth'} not exists $options{"tokens"} not exists $global->{"section"}{"instance $name"}{"tokens"} !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
Truth table0%0/5
A and not(B) and not(C) && not(D)
A= $http{'auth'}B= not exists $options{"tokens"}C= not exists $global->{"section"}{"instance $name"}{"tokens"}D= !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
ABCDresult
0XXX0
10XX0
110X0
11100
11111
Truth table0%0/5
A and not(B) and not(C) && not(D)
A= $http{'auth'}B= not exists $options{"tokens"}C= not exists $global->{"section"}{"instance $name"}{"tokens"}D= !exists $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}{'tokens'}
ABCDresult
0XXX0
10XX0
110X0
11100
11111
1225  
1226 0 ▶ if ($managed) {
Branch: 2 branches
BranchTrueFalseTotal
if ($managed) { } 10 7 17
if ($managed) { } 0 0 0
1227 0 my $saved = (ref $global)->new (file => $global->{file});
1228 $saved->{section}{global}{secret} eq $global->{section}{global}{secret}
1229 0 ▶ or die "MCP master secret is not persistently stored in $global->{file}\n";
Branch: 2 branches
BranchTrueFalseTotal
$saved->{"section"}{"global"}{"secret"} eq $global->{"section"}{"global"}{"secret"} or die qq[MCP master secret is not persistently stored in $global->{"file"}\n] 9 1 10
$saved->{"section"}{"global"}{"secret"} eq $global->{"section"}{"global"}{"secret"} or die qq[MCP master secret is not persistently stored in $global->{"file"}\n] 0 0 0
1230 0 my $credentials = $global->user_credentials ($name);
1231 0 ▶ if (length $print_url) {
Branch: 2 branches
BranchTrueFalseTotal
if (length $print_url) 3 6 9
if (length $print_url) 0 0 0
1232 0 @$credentials = grep $_->[0] eq $print_url, @$credentials;
1233 0 ▶ @$credentials or die "User '$print_url' is not enabled\n";
Branch: 2 branches
BranchTrueFalseTotal
@$credentials or die "User '${print_url}' is not enabled\n" 2 1 3
@$credentials or die "User '${print_url}' is not enabled\n" 0 0 0
1234 }
1235 0 my $connect = $global->connect_user ($name);
1236 0 for my $entry (@$credentials) {
1237 0 my ($user, $principal, $token) = @$entry;
1238 0 for my $scheme (@schemes) {
1239 0 ▶ print $global->http_url ($name, $selected_bind, %options,
Branch: 2 branches
BranchTrueFalseTotal
$user eq $connect ? : 6 3 9
$user eq $connect ? : 0 0 0
1240 tokens => [$token], url_scheme => $scheme),
1241 " # user $principal", ($user eq $connect ? " (connect)" : ""), "\n";
1242 }
1243 }
1244 } else {
1245 0 ▶ length $print_url
Branch: 2 branches
BranchTrueFalseTotal
length $print_url and die "Cannot select a managed user with explicit tokens or auth=none\n" 0 7 7
length $print_url and die "Cannot select a managed user with explicit tokens or auth=none\n" 0 0 0
1246 and die "Cannot select a managed user with explicit tokens or auth=none\n";
1247 0 for my $scheme (@schemes) {
1248 0 print $global->http_url ($name, $selected_bind, %options, url_scheme => $scheme), "\n";
1249 }
1250 }
1251 0 exit;
1252 }
1253  
1254 0 \%server
1255 }
1256  
1257 428 ▶sub _permission_options {
Subroutine _permission_options: called CC=3 SCAR=11.0
1258 428 my %kv = @_;
1259  
1260 428 ▶ if (my $rules = delete $kv{auto_rules}) {
Branch: 1 branch
BranchTrueFalseTotal
if (my $rules = delete $kv{"auto_rules"}) 28 400 428
1261 28 require AnyEvent::MCP::Server::Permissions;
1262 28 ▶ my $permissions = $kv{permissions} ||= AnyEvent::MCP::Server::Permissions->new;
Condition66%2/3
$kv{"permissions"} ||= "AnyEvent::MCP::Server::Permissions"->new
l!l&&r!l&&!r
2710
MC/DC0%0/2
$kv{"permissions"} ||= "AnyEvent::MCP::Server::Permissions"->new
$kv{"permissions"} "AnyEvent::MCP::Server::Permissions"->new
Truth table66%2/3
A ||= B
A= $kv{"permissions"}B= "AnyEvent::MCP::Server::Permissions"->new
ABresult
1X1
011
000
1263 28 $permissions->auto_rules ($rules);
1264 }
1265  
1266 %kv
1267 428 }
1268  
1269 220 ▶sub _server_options {
Subroutine _server_options: called CC=6 SCAR=17.9
1270 220 my %kv = @_;
1271  
1272 220 ▶ if (exists $kv{server_name} || exists $kv{server_version}) {
Branch: 1 branch
BranchTrueFalseTotal
if (exists $kv{"server_name"} or exists $kv{"server_version"}) 188 32 220
Condition100%3/3
exists $kv{"server_name"} or exists $kv{"server_version"}
l!l&&r!l&&!r
187132
MC/DC100%2/2
exists $kv{"server_name"} or exists $kv{"server_version"}
exists $kv{"server_name"} exists $kv{"server_version"}
Truth table100%3/3
A or B
A= exists $kv{"server_name"}B= exists $kv{"server_version"}
ABresult
1X1
011
000
1273 !exists $kv{server_info}
1274 188 ▶ or die "Cannot combine server_info with server_name/server_version\n";
Branch: 1 branch
BranchTrueFalseTotal
exists $kv{"server_info"} and die "Cannot combine server_info with server_name/server_version\n" 1 187 188
1275  
1276 187 my $name = delete $kv{server_name};
1277 187 my $version = delete $kv{server_version};
1278 $kv{server_info} = {
1279 187 ▶ name => defined $name ? $name : "AnyEvent::MCP",
Branch: 2 branches
BranchTrueFalseTotal
defined $name ? : 186 1 187
defined $version ? : 187 0 187
1280 version => defined $version ? "$version" : "$AnyEvent::MCP::VERSION",
1281 };
1282 }
1283  
1284 %kv
1285 219 }
1286  
1287 212 ▶sub mcp_start {
Subroutine mcp_start: called CC=25 SCAR=32.7
Pod documented
1288 212 require AnyEvent::MCP::Config;
1289  
1290 212 my %kv = (%config, @_);
1291 212 ▶ mcp_tool_help (delete $kv{tool_help}, @{$kv{toolsets} || [$toolset]});
Condition100%2/2
$kv{'toolsets'} || [$toolset]
l!l
32180
MC/DC100%1/1
$kv{'toolsets'} || [$toolset]
$kv{'toolsets'}
Truth table100%2/2
A
A= $kv{'toolsets'}
Aresult
11
00
1292 210 my $name = AnyEvent::MCP::Config::server_name ($kv{name});
1293 210 my $config_file = AnyEvent::MCP::Config::_file ();
1294 210 ▶ my $global = -e $config_file ? AnyEvent::MCP::Config->global : undef;
Branch: 1 branch
BranchTrueFalseTotal
-e $config_file ? : 85 125 210
1295 my %ini = $global ? (
1296 85 ▶ %{$global->{section}{"program " . AnyEvent::MCP::Config::program_name ()} || {}},
Condition100%2/2
$global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()} || {}
l!l
4936
MC/DC100%1/1
$global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()} || {}
$global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}
Truth table100%2/2
A
A= $global->{'section'}{'program ' . AnyEvent::MCP::Config::program_name()}
Aresult
11
00
1297 210 ▶ %{$global->{section}{"instance $name"} || {}},
Branch: 1 branch
BranchTrueFalseTotal
$global ? : 85 125 210
Condition100%2/2
$global->{'section'}{"instance $name"} || {}
l!l
1669
MC/DC100%1/1
$global->{'section'}{"instance $name"} || {}
$global->{'section'}{"instance $name"}
Truth table100%2/2
A
A= $global->{'section'}{"instance $name"}
Aresult
11
00
1298 ) : ();
1299 210 ▶ if ($global) {
Branch: 1 branch
BranchTrueFalseTotal
if ($global) 85 125 210
1300 85 my @rules = $global->auto_rules ($name);
1301 0 ▶ $kv{auto_rules} = [@{$kv{auto_rules} || []}, @rules] if @rules;
Branch: 1 branch
BranchTrueFalseTotal
if @rules 0 85 85
Condition0%0/2
$kv{'auto_rules'} || []
l!l
00
MC/DC0%0/1
$kv{'auto_rules'} || []
$kv{'auto_rules'}
Truth table0%0/2
A
A= $kv{'auto_rules'}
Aresult
11
00
1302 }
1303 $kv{custom_instructions} = $ini{custom_instructions}
1304 210 ▶ if !exists $kv{custom_instructions} && exists $ini{custom_instructions};
Branch: 1 branch
BranchTrueFalseTotal
if not exists $kv{"custom_instructions"} and exists $ini{"custom_instructions"} 0 210 210
Condition33%1/3
not exists $kv{"custom_instructions"} and exists $ini{"custom_instructions"}
!ll&&!rl&&r
02100
MC/DC0%0/2
not exists $kv{"custom_instructions"} and exists $ini{"custom_instructions"}
not exists $kv{"custom_instructions"} exists $ini{"custom_instructions"}
Truth table33%1/3
not(A) and B
A= not exists $kv{"custom_instructions"}B= exists $ini{"custom_instructions"}
ABresult
0X0
100
111
1305 210 %kv = _permission_options (%kv);
1306 210 my $stdio = delete $kv{stdio};
1307 210 my $listen = delete $kv{listen};
1308 210 my $connect = delete $kv{connect};
1309 210 ▶ !($stdio && defined $connect) or die "Cannot combine --stdio and --connect\n";
Branch: 1 branch
BranchTrueFalseTotal
($stdio and defined $connect) and die "Cannot combine --stdio and --connect\n" 0 210 210
Condition66%2/3
$stdio and defined $connect
!ll&&!rl&&r
591510
MC/DC0%0/2
$stdio and defined $connect
$stdio defined $connect
Truth table66%2/3
A and B
A= $stdioB= defined $connect
ABresult
0X0
100
111
1310 210 ▶ $stdio ||= !defined $connect && $ENV{PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL} eq "stdio";
Condition100%6/6
$stdio ||= !defined($connect) && $ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio"
l!l&&r!l&&!r
151527
!defined($connect) && $ENV{'PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL'} eq 'stdio'
!ll&&!rl&&r
1652
MC/DC0%0/3
$stdio ||= !defined($connect) && $ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio"
$stdio !defined($connect) $ENV{'PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL'} eq 'stdio'
Truth table0%0/4
A ||= not(B) && C
A= $stdioB= !defined($connect)C= $ENV{'PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL'} eq 'stdio'
ABCresult
1XX1
0111
00X0
0100
1311  
1312 210 $kv{name} = $name;
1313  
1314 210 ▶ if (!$listen) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($listen) 209 1 210
1315 209 ▶ return mcp_connect (%kv, connect => $connect) if defined $connect;
Branch: 1 branch
BranchTrueFalseTotal
if defined $connect 1 208 209
1316 208 ▶ return mcp_stdio (%kv) if $stdio;
Branch: 1 branch
BranchTrueFalseTotal
if $stdio 202 6 208
1317 }
1318  
1319 7 ▶ my %http = ($global ||= AnyEvent::MCP::Config->global)->http_settings ($name, delete $kv{bind});
Condition66%2/3
$global ||= "AnyEvent::MCP::Config"->global
l!l&&r!l&&!r
430
MC/DC0%0/2
$global ||= "AnyEvent::MCP::Config"->global
$global "AnyEvent::MCP::Config"->global
Truth table66%2/3
A ||= B
A= $globalB= "AnyEvent::MCP::Config"->global
ABresult
1X1
011
000
1320 7 ▶ delete @http{qw(tokens connect_tokens token_users)} if ($kv{auth} || "") eq "none";
Branch: 1 branch
BranchTrueFalseTotal
if ($kv{"auth"} || "") eq "none" 1 6 7
Condition100%2/2
$kv{'auth'} || ''
l!l
16
MC/DC100%1/1
$kv{'auth'} || ''
$kv{'auth'}
Truth table100%2/2
A
A= $kv{'auth'}
Aresult
11
00
1321 7 my %options = (path => "/", %http, %kv);
1322 7 ▶ if (exists $kv{tokens}) {
Branch: 1 branch
BranchTrueFalseTotal
if (exists $kv{"tokens"}) 3 4 7
1323 3 $options{connect_tokens} = $kv{tokens};
1324 3 delete $options{token_users};
1325 }
1326  
1327 7 ▶ if ($stdio || defined $connect) {
Branch: 1 branch
BranchTrueFalseTotal
if ($stdio or defined $connect) 1 6 7
Condition66%2/3
$stdio or defined $connect
l!l&&r!l&&!r
106
MC/DC50%1/2
$stdio or defined $connect
$stdio defined $connect
Truth table66%2/3
A or B
A= $stdioB= defined $connect
ABresult
1X1
011
000
1328 1 require AnyEvent::MCP::Server::HTTP;
1329 1 my $listener = AnyEvent::MCP::Server::HTTP->new (toolsets => [$toolset], _server_options (%options));
1330 1 $listener->listen;
1331 1 ▶ my $result = defined $connect
Branch: 1 branch
BranchTrueFalseTotal
defined $connect ? : 0 1 1
1332 ? mcp_connect (%kv, connect => $connect)
1333 : mcp_stdio (%kv);
1334 1 $listener->close;
1335 1 return $result
1336 }
1337  
1338 6 mcp_http (%options)
1339 }
1340  
1341 1 ▶sub mcp_connect {
Subroutine mcp_connect: called CC=2 SCAR=7.0
Pod documented
1342 1 require AnyEvent::MCP::Server::Connect;
1343  
1344 1 my %kv = _server_options (%config, @_);
1345 1 ▶ mcp_tool_help (delete $kv{tool_help}, @{$kv{toolsets} || [$toolset]});
Condition50%1/2
$kv{'toolsets'} || [$toolset]
l!l
01
MC/DC0%0/1
$kv{'toolsets'} || [$toolset]
$kv{'toolsets'}
Truth table50%1/2
A
A= $kv{'toolsets'}
Aresult
11
00
1346 1 my $server = AnyEvent::MCP::Server::Connect->new (toolsets => [$toolset], _permission_options (%kv));
1347 1 $server->start;
1348 1 _run ($server, 1)
1349 }
1350  
1351 204 ▶sub mcp_stdio {
Subroutine mcp_stdio: called CC=6 SCAR=19.1
Pod documented
1352 204 require AnyEvent::MCP::Server::JSONL;
1353  
1354 204 my %kv = _permission_options (_server_options (%config, @_));
1355 204 ▶ mcp_tool_help (delete $kv{tool_help}, @{$kv{toolsets} || [$toolset]});
Condition100%2/2
$kv{'toolsets'} || [$toolset]
l!l
30174
MC/DC100%1/1
$kv{'toolsets'} || [$toolset]
$kv{'toolsets'}
Truth table100%2/2
A
A= $kv{'toolsets'}
Aresult
11
00
1356 204 my $idle_exit = delete $kv{idle_exit};
1357 204 binmode STDIN;
1358 204 binmode STDOUT;
1359 204 my $selected = select STDOUT;
1360 204 $| = 1;
1361 204 select $selected;
1362  
1363 204 my $server = AnyEvent::MCP::Server::JSONL->new (toolsets => [$toolset], %kv);
1364 204 $server->accept (\*STDIN, \*STDOUT);
1365  
1366 204 ▶ if ($idle_exit) {
Branch: 1 branch
BranchTrueFalseTotal
if ($idle_exit) 133 71 204
1367 133 ▶ $idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/ && $idle_exit > 0
Branch: 1 branch
BranchTrueFalseTotal
$idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/u and $idle_exit > 0 or die "invalid idle_exit seconds\n" 133 0 133
Condition33%1/3
$idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/u and $idle_exit > 0
!ll&&!rl&&r
00133
MC/DC0%0/2
$idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/u and $idle_exit > 0
$idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/u $idle_exit > 0
Truth table33%1/3
A and B
A= $idle_exit =~ /\A[0-9]+(?:\.[0-9]+)?\z/uB= $idle_exit > 0
ABresult
0X0
100
111
1368 or die "invalid idle_exit seconds\n";
1369 133 ▶ if ($ENV{PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL} eq "stdio") {
Branch: 1 branch
BranchTrueFalseTotal
if ($ENV{"PERL_ANYEVENT_MCP_MULTIBROKER_PROTOCOL"} eq "stdio") 1 132 133
1370 1 my ($timer, $check);
1371 0 ▶ $check = sub {
Subroutine __ANON__: not called CC=4 SCAR=30.0
1372 0 ▶ return if $server->{idle_exit_requested};
Branch: 1 branch
BranchTrueFalseTotal
if $server->{"idle_exit_requested"} 0 0 0
1373 0 ▶ if (grep $_->{mcp_active}, values %{$server->{connections} || {}}) {
Branch: 1 branch
BranchTrueFalseTotal
if (grep $_->{'mcp_active'}, values %{$server->{'connections'} or {};}) { } 0 0 0
Condition0%0/2
$server->{'connections'} || {}
l!l
00
MC/DC0%0/1
$server->{'connections'} || {}
$server->{'connections'}
Truth table0%0/2
A
A= $server->{'connections'}
Aresult
11
00
1374 0 $timer = AnyEvent->timer (after => $idle_exit, cb => $check);
1375 } else {
1376 0 $server->request_idle_exit;
1377 }
1378 1 };
1379 5 ▶ my $schedule = sub {
Subroutine __ANON__: called CC=1 SCAR=0.0
1380 5 $timer = AnyEvent->timer (after => $idle_exit, cb => $check);
1381 1 };
1382 1 my $on_request = $server->{on_request};
1383 2 ▶ $server->{on_request} = sub {
Subroutine __ANON__: called CC=3 SCAR=11.2
1384 2 my ($server, $req) = @_;
1385  
1386 2 ▶ if ($req->{method} ne "anyevent-mcp/shutdown") {
Branch: 1 branch
BranchTrueFalseTotal
if ($req->{"method"} ne "anyevent-mcp/shutdown") 2 0 2
1387 2 $server->{idle_exit_requested} = 0;
1388 2 $schedule->();
1389 2 my $reply = $req->{on_reply};
1390 2 ▶ $req->{on_reply} = sub {
Subroutine __ANON__: called CC=2 SCAR=7.2
1391 2 $reply->(@_);
1392 2 ▶ $schedule->() unless $server->{_idle_shutting_down};
Branch: 1 branch
BranchTrueFalseTotal
unless $server->{"_idle_shutting_down"} 2 0 2
1393 2 };
1394 }
1395 2 ▶ $on_request->(@_) if $on_request;
Branch: 1 branch
BranchTrueFalseTotal
if $on_request 2 0 2
1396 1 };
1397 1 my $on_close = $server->{on_close};
1398 1 ▶ $server->{on_close} = sub {
Subroutine __ANON__: called CC=2 SCAR=7.2
1399 1 undef $timer;
1400 1 ▶ $on_close->(@_) if $on_close;
Branch: 1 branch
BranchTrueFalseTotal
if $on_close 0 1 1
1401 1 };
1402 1 $schedule->();
1403 }
1404 }
1405 204 _run $server
1406 }
1407  
1408 14 ▶sub mcp_http {
Subroutine mcp_http: called CC=2 SCAR=6.9
Pod documented
1409 14 require AnyEvent::MCP::Server::HTTP;
1410  
1411 14 my %kv = _permission_options (_server_options (%config, @_));
1412 13 ▶ mcp_tool_help (delete $kv{tool_help}, @{$kv{toolsets} || [$toolset]});
Condition100%2/2
$kv{'toolsets'} || [$toolset]
l!l
211
MC/DC100%1/1
$kv{'toolsets'} || [$toolset]
$kv{'toolsets'}
Truth table100%2/2
A
A= $kv{'toolsets'}
Aresult
11
00
1413 13 my $server = AnyEvent::MCP::Server::HTTP->new (toolsets => [$toolset], %kv);
1414 13 $server->listen;
1415 13 _run $server
1416 }
1417  
1418 218 ▶sub _run {
Subroutine _run: called CC=4 SCAR=13.9
1419 218 my ($server, $keep_alive) = @_;
1420  
1421 218 my $cv = AnyEvent->condvar;
1422 218 my $stopped;
1423 218 ▶ my $stop = sub { $cv->send unless $stopped++ };
Subroutine __ANON__: called CC=2 SCAR=6.9
Branch: 1 branch
BranchTrueFalseTotal
unless $stopped++ 121 107 228
1424 218 my $on_close = $server->{on_close};
1425 121 ▶ $server->{on_close} = sub {
Subroutine __ANON__: called CC=2 SCAR=6.9
1426 121 ▶ $on_close->(@_) if $on_close;
Branch: 1 branch
BranchTrueFalseTotal
if $on_close 2 119 121
1427 121 $stop->();
1428 218 };
1429  
1430 218 ▶ if (!$keep_alive && $server->isa ("AnyEvent::MCP::Server::JSONL")) {
Branch: 1 branch
BranchTrueFalseTotal
if (not $keep_alive and $server->isa("AnyEvent::MCP::Server::JSONL")) 204 14 218
Condition100%3/3
not $keep_alive and $server->isa("AnyEvent::MCP::Server::JSONL")
!ll&&!rl&&r
113204
MC/DC100%2/2
not $keep_alive and $server->isa("AnyEvent::MCP::Server::JSONL")
not $keep_alive $server->isa("AnyEvent::MCP::Server::JSONL")
Truth table100%3/3
not(A) and B
A= not $keep_aliveB= $server->isa("AnyEvent::MCP::Server::JSONL")
ABresult
0X0
100
111
1431 204 my $on_connection_close = $server->{on_connection_close};
1432 107 ▶ $server->{on_connection_close} = sub {
Subroutine __ANON__: called CC=2 SCAR=7.2
1433 107 ▶ $on_connection_close->(@_) if $on_connection_close;
Branch: 1 branch
BranchTrueFalseTotal
if $on_connection_close 0 107 107
1434 107 $stop->();
1435 204 };
1436 }
1437  
1438 my @signals = map {
1439 218 ▶ AnyEvent->signal (signal => $_, cb => sub { $server->close })
Subroutine __ANON__: called CC=1 SCAR=0.0
1440 436 } qw(INT TERM);
1441  
1442 218 my $ok = eval {
1443 218 $server->event (start =>);
1444 217 $cv->recv;
1445 117 1
1446 };
1447 118 my $error = $@;
1448 118 $server->close;
1449 118 ▶ die $error unless $ok;
Branch: 1 branch
BranchTrueFalseTotal
unless $ok 1 117 118
1450 return
1451 117 }
1452  
1453 296 1
« bin/anyevent-mcp-form-elicitation ↑ Summary bin/mcp-webbrowser »