Skip to content

Conversation

@thesurenk
Copy link

  • Add server configuration for helidon-mcp-server
  • Includes Docker image, tools definition, and documentation
  • Server implements MCP protocol with JSON-RPC support
  • Built with Java 21 and Helidon framework
  • Successfully tested locally with Docker MCP gateway

name: Add a new MCP server
about: Requests for adding a new MCP server to the Docker Catalog
title: "Add Helidon MCP Server"
labels: submission
assignees: ""

MCP Server Information

Server Name: helidon-mcp-server
Repository URL: https://github.com/thesurenk/helidon-mcp-server
Brief Description: A base MCP (Model Context Protocol) server implementation using Helidon framework, containerized with Docker for easy deployment and testing. Built with Java 21 and Helidon 4.0.7, implements MCP protocol with JSON-RPC support.

Basic Requirements

  • [x ] Open Source: Uses acceptable license (Apache-2.0, MIT, BSD-2-Clause, BSD-3-Clause or other permissive license)
  • [x ] MCP Compliant: Implements MCP API specification
  • [ x] Active Development: Recent commits and maintained
  • [ x] Docker Artifact: Dockerfile
  • [ x] Documentation: Basic README and setup instructions
  • [x ] Security Contact: Method for reporting security issues

Submitter Checklist

  • [ x] This server meets the basic requirements listed above
  • [x ] I understand this will undergo automated and manual review.
  • [x ] I have tested the MCP Server using task validate -- --name SERVER_NAME
  • [ x] I have built the MCP Server using task build -- --tools SERVER_NAME

Additional Information

Features

  • MCP Protocol Support: Implements the Model Context Protocol for tool discovery and execution
  • Docker Containerized: Ready-to-use Docker image with multi-stage build
  • Java 21: Built with modern Java features and Helidon 4.0.7
  • Self-contained JAR: All dependencies included in a single executable JAR
  • HTTP Server: RESTful API endpoints for MCP protocol communication
  • JSON-RPC Support: Full JSON-RPC 2.0 protocol implementation

Framework & Technology

  • Helidon Framework: Built using Helidon 4.0.7 - Oracle's modern Java microservices framework
  • Java 21: Leverages modern Java features and performance improvements
  • Docker Multi-stage Build: Optimized container image with separate build and runtime stages
  • Maven: Standard Java build tool with comprehensive dependency management

Testing Results

  • ✅ Docker image builds successfully (mcp/helidon-mcp-server)
  • ✅ Server responds to HTTP requests (http://localhost:8080/)
  • ✅ MCP endpoint works with JSON-RPC protocol (http://localhost:8080/mcp)
  • ✅ Tools discovery works correctly
  • ✅ Successfully tested locally with Docker MCP gateway

Files Added

  • servers/helidon-mcp-server/server.yaml - Server configuration
  • servers/helidon-mcp-server/tools.json - Tools definition
  • servers/helidon-mcp-server/readme.md - Documentation

References

- Add server configuration for helidon-mcp-server
- Includes Docker image, tools definition, and documentation
- Server implements MCP protocol with JSON-RPC support
- Built with Java 21 and Helidon framework
- Successfully tested locally with Docker MCP gateway
@thesurenk thesurenk requested a review from a team as a code owner October 23, 2025 18:26
@thesurenk
Copy link
Author

team, any updates on this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant