Introduce mcp server cli adapter

[iocanel]

Resolves: #157

[iocanel]

I am currently working on the failing test.

[iocanel]

@mkouba applied your feedback. I now have to fix the broken test. For some reason it's behaving pretty random (e.g. most of the time no response is received). Any insight?

[mkouba]

@mkouba applied your feedback. I now have to fix the broken test. For some reason it's behaving pretty random (e.g. most of the time no response is received). Any insight?

I can try to take a look..

[mkouba]

I think we should move the cli-adapter dir in the project root.

[iocanel]

Added an abstract command that contains the --mcp flag and optionally starts the server or executes the actual command.

I tried to use byte code transformers to get the @TopCommand extend the forementioned abstract class but that does not work even though generated bytecode seems ok (after decompiling it). So, I guess its an order/visibility issue or something like it.

[iocanel]

Currently, the user just needs to drop the dependency into a project that contains a @topcommand.
The extension will automagically add the --mcp option to the top command. When used it starts an mcp server with all the reachable subcommands added.

[geoand]

This is so cool!

[mkouba]

It looks pretty cool. I've added a few minor comments.

[iocanel]

@mkouba applied feedback

[melloware]

@iocanel i will definitely need this I have a CLI i want to test this with!

[melloware]

@iocanel i built this locally and trying it with my Picocli to get it running and I can't

My CLI: https://github.com/ksmpartners/domino-cli

When I added

        <dependency>
            <groupId>io.quarkiverse.mcp</groupId>
            <artifactId>quarkus-mcp-server-cli-adapter</artifactId>
            <version>999-SNAPSHOT</version>
        </dependency>

Then run mvn clean package

Then run java -jar domino-cli-6.0.1.2-SNAPSHOT.jar --mcp it ERRORS with...Unknown option: '--mcp'

[iocanel]

Will have a look first thing in the morning

[mkouba]

@iocanel i built this locally and trying it with my Picocli to get it running and I can't

My CLI: https://github.com/ksmpartners/domino-cli

When I added

        <dependency>
            <groupId>io.quarkiverse.mcp</groupId>
            <artifactId>quarkus-mcp-server-cli-adapter</artifactId>
            <version>999-SNAPSHOT</version>
        </dependency>

Then run mvn clean package

Then run java -jar domino-cli-6.0.1.2-SNAPSHOT.jar --mcp it ERRORS with...Unknown option: '--mcp'

Pls file a new issue.

[iocanel]

@melloware: You should be using: java -jar target/quarkus-app/quarkus-run.jar --mcp instead, which from what I see is working fine.

[melloware]

@iocanel when I do that I get this error...

C:\dev\ksm\domino-cli>java -jar target/quarkus-app/quarkus-run.jar --mcp

Domino CLI
Usage: domino [-hV] [--mcp] [-k=<apiKey>] [-o=<outputFormat>]
              [-t=<timeoutSeconds>] [-u=<apiUrl>] [COMMAND]

Domino Data Lab Command Line Interface is a client to used provision and
control Domino.

  -h, --help           Show this help message and exit.
  -k, --key=<apiKey>   Domino API Key.
      --mcp            Start an MCP server for the current CLI.
  -o, --output=<outputFormat>
                       Output format TEXT, JSON, XML
  -t, --timeout=<timeoutSeconds>
                       Timeout in seconds waiting for Domino responses.
  -u, --url=<apiUrl>   Domino API URL.
  -V, --version        Print version information and exit.
Commands:
  collaborator
                Collaborator related functions
  dataset
                Dataset related functions
  datasource
                DataSource related functions
  goal
                Goal related functions
  job
                Job related functions
  user
                User related functions
  project
                Project related functions
  run
                Run related functions
  server
                Server related functions

Also it seems the uber-jar I build for JReleaser doesn't seem to contain this --mcp setting.