mcp-annotated-java-sdk

Overview

This is a lightweight annotation-based framework for MCP server development in Java. It allows developers to define, develop, and integrate MCP Resources, Prompts, and Tools with minimal code without requiring the Spring Framework. The SDK reduces development time from 50-100 lines to just 5-10 lines of code by eliminating the need for manual JSON schema definitions and complex setup. It supports multiple server modes (STDIO, SSE, STREAMABLE), offers multilingual support, and maintains full type safety through Java's type system.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• addpublic int add(int a, int b)

  Calculate the sum of two numbers

  Try:What is the sum of 5 and 3?Try:Calculate 17 plus 24

Note: The README provides a clear example of an MCP tool definition with annotations. The 'add' tool is explicitly documented with its implementation, signature, and parameters.

Comparable tools

Installation

<dependency>
    <groupId>io.github.thought2code</groupId>
    <artifactId>mcp-annotated-java-sdk</artifactId>
    <version>0.14.0</version>
</dependency>

implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.14.0'

enabled: true
mode: STREAMABLE
name: my-mcp-server
version: 1.0.0
type: SYNC
instructions: You are a helpful AI assistant
request-timeout: 20000
capabilities:
  resource: true
  prompt: true
  tool: true
change-notification:
  resource: true
  prompt: true
  tool: true

{
  "mcpServers": {
    "my-java-mcp": {
      "command": "java",
      "args": ["-jar", "path/to/your/mcp-server.jar"]
    }
  }
}

FAQ

Do I need Spring Framework?

No! This SDK is completely independent of Spring Framework. However, the configuration file format is compatible with Spring AI if you want.

What MCP components are supported?

This SDK supports MCP Resources (expose data to LLM), Tools (execute actions), and Prompts (reusable templates). All can be defined using annotations.

Compare mcp-annotated-java-sdk with