Model Context Protocol Server 1.0 updates and more in 26.0.0.2-beta

// common imports for all classes below

import io.openliberty.mcp.annotations.Tool;
import io.openliberty.mcp.annotations.ToolArg;
import jakarta.annotation.security.PermitAll;
import jakarta.annotation.security.RolesAllowed;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class BookShopTools {

    // Admin Tool
    @RolesAllowed("Admins")
    @Tool(name = "banUser")
    public String banUser(@ToolArg(name = "userName", description = "Name of user to be banned") String userName)  {...}

    // Moderator Tools
    @RolesAllowed("Moderators")
    @Tool(name = "addBook")
    public String addBook(@ToolArg(name = "bookCode", description = "Code to uniquely identify the book") String bookCode)  {...}

    @RolesAllowed("Moderators")
    @Tool(name = "deleteBook")
    public String deleteBook(@ToolArg(name = "bookCode", description = "Code to uniquely identify the book") String bookCode)  {...}

    // User Tools
    @RolesAllowed("Users")
    @Tool(name = "buyBook")
    public String buyBook(@ToolArg(name = "bookCode", description = "Code to uniquely identify the book") String bookCode) {...}

    @RolesAllowed("Users")
    @Tool(name = "trackBookPrice")
    public String trackBookPrice(@ToolArg(name = "bookCode", description = "Code to uniquely identify the book") String bookCode)  {...}
}

@ApplicationScoped
@PermitAll // PermitAll Class level Annotation applies to all class tools, unless overwritten on method level
public class PublicTools {

    @Tool(name = "displayBooks")
    public String displayBooks(@ToolArg(name = "bookCode", description = "Code to uniquely identify the book") String book)  {...}

    @Tool(name = "registerNewUser")
    public String registerNewUser(@ToolArg(name = "userName", description = "The name for the user to be registered") String input,
                                  @ToolArg(name = "password", description = "The password for the user to be registered") String input)  {...}
}

<server description="Liberty server config for Security Annotations">

  <featureManager>
    <feature>servlet-6.0</feature>
    <feature>cdi-4.0</feature>
    <feature>mcpServer-1.0</feature>
    <!-- The following two features are required for application security to work -->
    <feature>appSecurity-5.0</feature>
    <feature>transportSecurity-1.0</feature>
  </featureManager>

  <include location="../fatTestPorts.xml" />

  <!-- Required for passwords to be encrypted using HTTPS -->
  <keyStore id="defaultKeyStore" password="Liberty" />

  <!-- Required to define https port for TLS (Transport Layer Security) -->
  <httpEndpoint id="defaultHttpEndpoint"
                httpPort="-1"
                httpsPort="9443">
  </httpEndpoint>

  <basicRegistry id="basic" realm="BasicRealm">

       <!-- Basic user authentication setup -->

       <!-- Users -->
       <user name="Sam"   password="{xor}KzosKy8+LDwoMC07aw=="/>
       <user name="Nile"  password="{xor}KzosKy8+LRwoMC07aw=="/>
       <user name="Cloe"  password="{xor}KzosKy8+LEwoMC07aw=="/>
       <user name="Vick"  password="{xor}KzosKy8+LFwoMC07aw=="/>

       <!-- Moderators -->
       <user name="Sally" password="{xor}KzosKy8+LCwoMC07bQ=="/>
       <user name="Harry" password="{xor}KzosKy8+LCwoMC07bQ=="/>

       <!-- Admins -->
       <user name="Bob"   password="{xor}KzosKy8+LCwoMC07bA=="/>
       <user name="Noah"  password="{xor}KzosKy8+LCwoMC07aw=="/>


       <!-- Mapping users to groups for the RolesAllowed annotation (a group is equivalent to a role) -->

       <group name="Users">
           <member name="Nile"/>
           <member name="Sam"/>
           <member name="Cloe"/>
           <member name="Vick"/>
       </group>

       <group name="Moderators">
           <member name="Sally"/>
           <member name="Harry"/>
       </group>

       <group name="Admins">
           <member name="Bob"/>
           <member name="Noah"/>
       </group>

  </basicRegistry>
</server>

    @Tool(name = "noArgsRequest",
          title = "call tool without providing arguments in params",
          description = "return string made from args and metadata",
          structuredContent = false)
    public String noArgsRequest(Meta meta) {
        Jsonb jsonb = JsonbBuilder.create();
        String location = (String) meta.getValue(MetaKey.from("example.org/location"));
        BigDecimal timestamp = (BigDecimal) meta.getValue(MetaKey.from("timestamp"));
        String result = "You have called this tool from " + location + " at timestamp " + timestamp.toString();
        return result;
    }

   @Tool(name = "addPersonToListToolResponse",
         title = "adds person to people list",
         description = "adds person to people list",
         structuredContent = true)
    public @Schema(value = "{ ... }",description = "Returns list of person object")
    ToolResponse addPersonToListToolResponse(@ToolArg(name = "employeeList", description = "List of people") List<Person> employeeList,
                                             @ToolArg(name = "person", description = "Person object") Optional<Person> person) {
        Person personInstance = person.get();
        employeeList.add(personInstance);
        Jsonb jsonb = JsonbBuilder.create();
        Map<MetaKey, Object> _meta = new HashMap<>();
        _meta.put(MetaKey.from("timestamp"), 1762860699);
        _meta.put(MetaKey.from("example.org/location"), "Hursley");
        _meta.put(MetaKey.from("example.org/person"), personInstance);
        return new ToolResponse(false, List.of(new TextContent(jsonb.toJson(employeeList))), employeeList, _meta);
    }

{
  "name": "ToolForMetaDataExample",
  "description": "ToolDescription",
  "inputSchema": { ... },
  "_meta": {
    // Rate Limiting Extension - com.example.rateLimit namespace
    "com.example.rateLimit/requests": 100,
    "com.example.rateLimit/period": "hour",
    "com.example.rateLimit/remaining": 47,
    // Cost Tracking Extension - com.example.cost namespace
    "com.example.cost/estimatedCost": 0.02,
    "com.example.cost/currency": "USD",
    // Caching Hints Extension - com.example.cache namespace
    "com.example.cache/cacheable": true,
    "com.example.cache/cacheKey": "LondonWeather",
    "com.example.cache/ttl": 300
  }
}