surendocker/helidon-mcp-server repository overview

# Pull the image
docker pull surendocker/helidon-mcp-server

# Run the server
docker run -d -p 8080:8080 --name helidon-mcp-server surendocker/helidon-mcp-server

# Test the server
curl http://localhost:8080/
curl http://localhost:8080/mcp

# Run with default settings
docker run -d -p 8080:8080 surendocker/helidon-mcp-server

# Run with custom name and restart policy
docker run -d \
  --name helidon-mcp-server \
  -p 8080:8080 \
  --restart unless-stopped \
  surendocker/helidon-mcp-server

# Run with custom Java options
docker run -d \
  -p 8080:8080 \
  -e JAVA_OPTS="-Xmx512m -Xms256m" \
  surendocker/helidon-mcp-server

# Create custom network
docker network create mcp-network

# Run on custom network
docker run -d \
  --name helidon-mcp-server \
  --network mcp-network \
  -p 8080:8080 \
  surendocker/helidon-mcp-server

curl http://localhost:8080/
# Response: "Helidon MCP Server is running!"

curl http://localhost:8080/mcp
# Response: "MCP endpoint available"

# Test MCP protocol
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"mcp/list-tools","id":1}'

# Response: {"jsonrpc":"2.0","result":"MCP server response","id":1}

# Test server is running
curl -f http://localhost:8080/ || echo "Server not responding"

# Test MCP endpoint
curl -f http://localhost:8080/mcp || echo "MCP endpoint not responding"

# Test MCP list-tools
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"mcp/list-tools","id":1}' \
  -w "\nHTTP Status: %{http_code}\nResponse Time: %{time_total}s\n"

# Concurrent request testing
for i in {1..10}; do
  curl -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -d "{\"jsonrpc\":\"2.0\",\"method\":\"mcp/ping\",\"id\":$i}" &
done
wait

# View container logs
docker logs helidon-mcp-server

# Follow logs in real-time
docker logs -f helidon-mcp-server

# View last 50 log lines
docker logs --tail 50 helidon-mcp-server

# Monitor container resource usage
docker stats helidon-mcp-server

# Check container details
docker inspect helidon-mcp-server

# Stop the container
docker stop helidon-mcp-server

# Start the container
docker start helidon-mcp-server

# Restart the container
docker restart helidon-mcp-server

# Remove the container
docker rm -f helidon-mcp-server

# Check container status
docker ps -a --filter name=helidon-mcp-server

# Check container logs for errors
docker logs helidon-mcp-server 2>&1 | grep -i error

# Test connectivity from inside container
docker exec helidon-mcp-server curl http://localhost:8080/

# Check Java process
docker exec helidon-mcp-server jps -v

# Clone the repository
git clone https://github.com/thesurenk/helidon-mcp-server.git
cd helidon-mcp-server

# Build the Docker image
docker build -t surendocker/helidon-mcp-server .

# Run locally
docker run -d -p 8080:8080 surendocker/helidon-mcp-server

# Run tests
mvn test

# Run with coverage
mvn test jacoco:report

# Run specific test suite
mvn test -Dtest=McpServerTest