solon-ai-mcp-embedded-examples

What is solon-ai-mcp-embedded-examples?

An example project for the solon-ai ecosystem, containing practical code for LLM (chatModel, tool call, skills, RAG) and MCP (server, client with SSE/streamable) usage. It also demonstrates integrating solon‑ai into various frameworks (Solon, Spring Boot, Quarkus, JFinal, Vert.x, etc.) across multiple Java versions.

How to use solon-ai-mcp-embedded-examples?

Clone the repository and navigate to the desired sub‑example. For LLM examples, you must modify the constants in llm/_Constants before running. MCP examples require a Solon container. The project is updated frequently; sync often to get the latest examples.

Key features of solon-ai-mcp-embedded-examples

• Covers LLM basics: chat, tool call, skills, RAG
• Full MCP examples: server & client, SSE & streamable transports
• Supports Java 8, 11, 17, 21, 25 (Java 8+)
• Integrates solon-ai into 10+ framework environments
• Includes unit tests for LLM and MCP components
• Adheres to the MCP_2025_03_26 protocol

Use cases of solon-ai-mcp-embedded-examples

• Learning how to use solon-ai chat models with different frameworks
• Building a tool‑calling agent with solon-ai
• Setting up an MCP server and client in a Solon application
• Implementing RAG workflows (embedding, repository, splitter)
• Comparing LLM/MCP integration across Spring Boot, Quarkus, Vert.x, etc.

FAQ from solon-ai-mcp-embedded-examples

What Java versions are supported?

Java 8, 11, 17, 21, and 25 (Java 8 and later).

Do I need to configure anything before running the LLM examples?

Yes, you must modify the constant configuration in llm/_Constants; otherwise, the examples will fail on startup.

Does the MCP server example require a specific runtime?

Yes, the MCP server example requires a Solon container to run.

Are there examples that only contain LLM (no MCP)?

Yes, examples like solon-ai-in-webflux2-llm, solon-ai-in-webflux3-llm, and solon-ai-in-webflux4-llm include only LLM functionality, no MCP.

How often is this example project updated?

The project is updated frequently; it is recommended to sync the repository regularly.