lightweight-component/aj-mcp

AJ-MCP Легкий Java MCP SDK

AJ-MCP - это облегченный протокол SDK для Java. Предоставляет небольшой, прямой API для строительства. MCP-клиенты и серверы, особенно для существующих систем, которые должны оставаться на Java 8 или Spring Boot 2.x.

Поддерживает Java 8 и выше, а также Spring Boot 2.x. Легкий и маленький, с Jackson JSON и OkHttp в качестве основных зависимостей времени выполнения. Простота использования и расширения, с примерами и двуязычной документацией. Поддерживает STDIO, устаревший транспорт HTTP / SSE и потоковый HTTP. Внедрение изменений протокола MCP 2024-11-05, 2025-03-26 и 2025-06-18 с согласованием версий.

• Охватывает инструменты, ресурсы, шаблоны ресурсов, подсказки, завершение, пагинацию, подписки, отмену, регистрацию, корни, пробоотбор и вызывание.

Ознакомьтесь с тремя проектами компонентов MCP SDK:

Независимый проект AJ MCP Next нацелен на 2026-07-28 на Java 8 с использованием AJ Util. Он имеет модули ядра/клиента/сервера со STDIO и адаптерами HTTP без сеансов, отдельно от этого устаревшего SDK.

• AJ MCP Common, Общая библиотека для AJ-MCP, содержит реализацию Модельного контекста Протокол и некоторые другие общие

AJ-MCP A Lightweight Java MCP SDK

AJ-MCP is a lightweight Model Context Protocol (MCP) SDK for Java. It provides a small, direct API for building MCP clients and servers, especially for existing systems that must remain on Java 8 or Spring Boot 2.x.

• Supports Java 8 and above, and supports Spring Boot 2.x.
• Lightweight and small, with Jackson JSON and OkHttp as its main runtime dependencies.
• Easy to use and extend, with examples and bilingual documentation.
• Supports STDIO, the legacy HTTP/SSE transport, and Streamable HTTP.
• Implements MCP protocol revisions 2024-11-05, 2025-03-26, and 2025-06-18 with version negotiation.
• Covers tools, resources, resource templates, prompts, completion, pagination, subscriptions, cancellation, logging, roots, sampling, and elicitation.

Check out these three projects of MCP SDK components:

The independent AJ MCP Next project targets 2026-07-28 on Java 8 using AJ Util. It has core/client/server modules with STDIO and sessionless HTTP adapters, separate from this legacy SDK.

• AJ MCP Common, Common library for AJ-MCP, it contains the implementation of the Model Context Protocol and some other common classes.
• AJ MCP Client, MCP Client SDK.
• AJ MCP Server, MCP Server SDK.
• Samples for both client and server.
• Spring Streamable HTTP sample, with a dedicated StreamableHttpClientExample in samples/client (Java 8).

For further information, please refer to the User Manual website.

When to use AJ-MCP

AJ-MCP is intended for Java applications that need to expose existing business capabilities to AI clients, or consume MCP servers without upgrading the entire application stack. Typical uses include:

• wrapping an existing Java service as MCP tools, resources, or prompts;
• connecting a Java desktop or server application to a local STDIO MCP process;
• integrating MCP into Spring Boot 2.x or a Servlet-based application;
• supporting clients that negotiate different MCP protocol revisions.

JSON-RPC batch messages are intentionally not supported.

Modules