JavaOne MCP Server

A Model Context Protocol Server for Accessing JavaOne Presentations

JavaOne MCP Server is a lightweight Java application that implements the Model Context Protocol (MCP), allowing AI models to access information about JavaOne conference presentations. This server exposes presentation data through standardized MCP tools, making it easy to integrate with AI assistants that support the protocol.

Project Requirements

• Java 24
• Maven 3.8+
• Model Context Protocol SDK 0.9.0
• SLF4J for logging

Dependencies

This project relies on the following key components:

<!-- MCP SDK -->
<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
</dependency>

<!-- Logging -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-simple</artifactId>
</dependency>

Getting Started

After cloning the repository, you can build the project using Maven:

mvn clean package

This will create an executable JAR file in the target directory with all dependencies included.

How to Run the Application

Execute the JAR file to start the MCP server:

java -jar target/javaone-mcp-0.0.2.jar

The application starts an MCP server that communicates via standard input/output (STDIO) and provides access to JavaOne presentation data.

Understanding the Project Structure

Core Components

• Application.java: Main entry point that configures and starts the MCP server
• Presentation.java: Data model representing a JavaOne presentation
• PresentationTools.java: Service that provides presentation data and operations

MCP Server Configuration

The server is configured with:

• STDIO transport provider for communication
• Server information (name and version)
• Tool capabilities for accessing presentation data

McpSyncServer syncServer = McpServer.sync(transportProvider)
    .serverInfo("javaone-mcp-server", "0.0.1")
    .capabilities(McpSchema.ServerCapabilities.builder()
            .tools(true)
            .logging()
            .build())
    .tools(syncToolSpecification)
    .build();

Available Tools

The server exposes the following MCP tool:

• get_presentations: Returns a list of all JavaOne presentations

Testing with MCP Inspector

The MCP Inspector is a helpful tool for testing and debugging your MCP server. Follow these steps to test your JavaOne MCP Server:

1. Install Node.js if you haven't already
2. Navigate to your project directory and get the absolute path to the JAR file:

# On Linux/macOS
FULL_PATH=$(pwd)/target/javaone-mcp-0.0.2.jar
echo $FULL_PATH

# On Windows PowerShell
$FULL_PATH="$(Get-Location)\target\javaone-mcp-0.0.2.jar"
echo $FULL_PATH

1. Run the MCP Inspector with your server using the full path:

npx @modelcontextprotocol/inspector java -jar $FULL_PATH

1. In the Inspector interface:
   • Verify the server connection in the connection pane
   • Navigate to the "Tools" tab to see the get_presentations tool
   • Test the tool by clicking on it and viewing the response
   • Monitor logs in the Notifications pane

Integrating with Claude Desktop

To use this MCP server with Claude Desktop, add the following configuration:

1. First, get the absolute path to your JAR file:

# On Linux/macOS
FULL_PATH=$(pwd)/target/javaone-mcp-0.0.2.jar
echo $FULL_PATH

# On Windows PowerShell
$FULL_PATH="$(Get-Location)\target\javaone-mcp-0.0.2.jar"
echo $FULL_PATH

1. Open Claude Desktop preferences
2. Navigate to the "MCP Servers" section
3. Add a new server with the following configuration (replace the path with your actual full path):

{
  "javaone-mcp": {
    "command": "java",
    "args": [
      "-jar",
      "$FULL_PATH"
    ]
  }
}

Extending the Project

You can enhance this project in several ways:

Adding More Presentation Data

Modify the PresentationTools class to include additional presentations:

// In the PresentationTools constructor
var newPresentation = new Presentation(
    "Spring Boot 3.5 Deep Dive", 
    "https://example.com/spring-boot", 
    2025
);
this.presentations.add(newPresentation);

Creating Additional MCP Tools

Implement more tools to expose different functionality:

// Example of adding a tool to search presentations by title
var searchToolSpec = new McpServerFeatures.SyncToolSpecification(
    new McpSchema.Tool("search_presentations", "Search presentations by title", searchSchema),
    (exchange, arguments) -> {
        String query = arguments.get("query").asText();
        List<Presentation> results = presentationTools.searchPresentations(query);
        // Convert results to MCP content and return
    }
);

Implementing Advanced Features

• Add resource subscriptions for real-time updates
• Implement asynchronous tools for long-running operations
• Add authentication and authorization mechanisms

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Further Resources

• Model Context Protocol Specification
• MCP Inspector Documentation
• MCP Debugging Guide