Write a blog to talk about implementing MCP server by using Liberty

[gkwan-ibm]

Based on the MCP server sample app by issue #94, write a blog to talk about implementing MCP server by using MCP Java SDK and Liberty

[gkwan-ibm]

• update the example-location to use main branch
• The whole How does the application work? section seems descibing the classes independently. As a reader, I have a bit hard to understand the flow and the connection between them. Should have a summary at the beginning to descibe how to build a MCP server? e.g.

  How does the application work?
  ...
  To build a MCP server, you need to

  1. implement tools - like the StackOverflowService class in this sample application
  2. register the MCP Tools - like the StackOverflowAsyncTools class in this sample application
  3. integrate MCP streamable transport - like the McpServerInitializer class in this sample application

  Tool implementation
  ...
  Registering the MCP Tools
  ...
  Integrating the MCP Streamable HTTP transport with Jakarta Servlet
  ...

• in the Tool implementation section,
  • suggest to describe the objective of the StackOverflowService. See http://lgdev1.fyre.ibm.com:4022/blog/2025/09/11/open-liberty-with-langchain4j-tools-laura.html
  • suggest to list all the tools (if possible, add links to the code)
• in the Registering the MCP Tools section,
  • it says "The StackOverflowAsyncTools class registers methods ...". The class seems providing several methods.
    • Would you explain more how the methods are registered?
    • If not registering, may need to rename the section title and the methods with more meaningful name
• In the Integrating the MCP Streamable HTTP transport with Jakarta Servlet section,
  • is it more clear to explain to override the contextInitialized() method for creating..., registering...., and the contextDestroyed() method to closing...?

[gkwan-ibm]

• In the Setup section
  • need to change following because mvnw is located at mcp directory
    • cd sample-langchain4j/mcp/server -> cd sample-langchain4j/mcp
    • ./mvnw liberty:dev -> ./mvnw -pl server liberty:dev
• in the How does the application work? section
  • "The architecture consists..."
    • I doubt to use the word "architecture". Is "application" better?
    • suggest not use numbers for the list because the order is not really important
    • can make links to the below sections?
      • Tool implementation to the Tool implementation section
      • Tool definition to the Defining the MCP tools section
      • Server integration to the Integrating the MCP Streamable HTTP transport with Jakarta Servlet section

[shin19991207]

Update: the above comments are addressed