Overview

Docker MCP Hub - Helidon MCP Server is a containerized solution that centralizes and orchestrates Model Context Protocol (MCP) servers built with Helidon. I have updated the Helidon MCP server to be able to run in a Docker container and pushed it to the Docker MCP Hub. This project provides a unified platform for managing multiple AI-powered microservices, enabling developers to deploy, scale, and monitor MCP servers with ease.

🧩 Helidon MCP Server (Dockerized)

A minimal Helidon SE 4.3 implementation of the Model Context Protocol (MCP), packaged as a Docker container for use with the Docker MCP Hub and MCP Toolkit.

This container demonstrates how Java microservices can expose MCP-compatible tools and resources using Helidon’s declarative MCP APIs.

🚀 Overview

• Fully compliant Helidon MCP Server running over streamable-http
• Ready for local use or MCP Hub submission
• Exposes example MCP tools and resources
• Lightweight, stateless, and configurable via environment variables
• Ideal reference for developers learning to build MCP servers in Java

🐳 Quick Start

Build

docker build -t helidon-mcp-server:latest .

Run

docker run --rm -p 8080:8080 \
  -e MCP_PATH=/mcp/helidon \
  helidon-mcp-server:latest

Test

curl -i http://localhost:8080/mcp/helidon

The server will respond to MCP clients such as:

• Docker Desktop → MCP Toolkit
• Helidon MCP Client

⚙️ Configuration

Example configuration section for server.yaml:

config:
  description: Configuration for Helidon MCP Server
  env:
    - name: MCP_PATH
      example: /mcp/helidon
    - name: SERVER_PORT
      example: 8080

🧪 Test in Docker MCP Toolkit

task build -- --tools helidon-mcp-server
task catalog -- helidon-mcp-server
docker mcp catalog import catalogs/helidon-mcp-server/catalog.yaml

Then open Docker Desktop → MCP Toolkit, enable Helidon MCP Server, and test interactively.

To reset:

docker mcp catalog reset

🧭 Directory Layout

servers/helidon-mcp-server/
 ├── Dockerfile
 ├── server.yaml
 ├── tools.json
 ├── README.md

📄 License

Apache-2.0 — recommended for Helidon-based and Docker MCP Registry projects.

🙌 Credits

Originally developed by the Helidon Project (Oracle Labs).
Dockerization and MCP Hub submission prepared by community contributors following
Docker MCP Registry Guidelines.

🔗 References

• This propject
• This project on Docker MCP Hub !pending approval.
• Helidon MCP Documentation
• Model Context Protocol Specification
• Docker MCP Registry