This MCP server package provides example implementations for Solon-based AI integrations with MCP (Model Context Protocol). It includes sample configurations for LLM usage, tool calls, and skills, as well as MCP server and client patterns (supporting the MCP_2025_03_26 protocol). The server is intended to run within a Solon container environment, and demonstrates how to expose LLM prompts, tool calls, and Retrieval-Augmented Generation (RAG) workflows through a consistent MCP interface. To use it, start the MCP server jar and connect an MCP client to exchange requests (e.g., chat, tool calls, and skill invocations) following the examples illustrated in the repository. Ensure your environment has a compatible Java runtime and a Solon container if you plan to run the server inside that ecosystem.

Prerequisites:

• Java 8+ (preferably Java 11+ for compatibility) installed on your system
• Maven or Gradle for building from source (depending on project setup)
• Git to clone the repository

Step-by-step:

1. Clone the repository git clone <repository-url> cd solon-ai-embedded-examples

2. Build the project (example using Maven; adapt if using Gradle) mvn -q -DskipTests package

   or if there is a specific module for the MCP server

   mvn -q -pl :solon-ai-embedded-examples-mcp-server -DskipTests package

3. Locate the built MCP server jar

   Typical path after build

   ls target | grep mcp-server

4. Run the MCP server java -jar target/solon-ai-embedded-examples-mcp-server.jar

5. Run within a Solon container (optional but recommended)

   Ensure the container has Java and network access to MCP clients

   docker run -it --rm -v /path/to/config:/config -p 8080:8080 your-solon-container-image:latest

Prerequisites recap:

• Java Runtime Environment 8+ (prefer newer for long-term support)
• Build tool (Maven or Gradle) according to project setup
• Access to a Solon container if you intend to run with Solon integration

Note: If your environment uses a specific container or build script, adjust the commands accordingly based on the project’s provided guidance.

Tips and notes:

• This example set supports MCP_2025_03_26 protocol; confirm the protocol version in your environment if you have multiple MCP versions in use.
• The repository mentions multiple Java versions (Java 8, 11, 17, 21, 25) for compatibility; ensure your runtime matches the Java version the package was built with.
• If you encounter startup issues, verify that the Solon container has network access to MCP clients and that the MCP server jar path is correct.
• Environment variables such as JAVA_OPTS or SOLON_MCP_PROTOCOL can be used to tune performance or protocol behavior; supply appropriate values in your deployment environment.
• The MCP server exposes both server and client examples; when testing, use a compatible MCP client to validate chat, tool calls, skills, and RAG workflows.