JBang MCP Examples

What is JBang MCP Examples?

JBang MCP Examples is a collection of example MCP servers implemented in Java using JBang, enabling zero‑install execution. It provides ready‑to‑run servers such as a calculator, real‑weather, and stopwatch, aimed at developers exploring the Model Context Protocol.

How to use JBang MCP Examples?

Run the servers directly with jbang commands, e.g., jbang ./src/main/java/MCPCalculator.java or using shorthand jbang mcp-calculator@jabrena. Build and run Docker images with docker build and docker run. Use docker compose up to start multiple services, and view the web UI at http://localhost:3000/. An example AI application (AIApp.java) is also included.

Key features of JBang MCP Examples

• Multiple example MCP servers: Calculator, RealWeather, StopWatch
• Zero‑install Java execution via JBang
• Docker and Docker Compose support for containerized deployment
• Includes a sample AI application integrating with MCP
• Shorthand JBang aliases (mcp-calculator@jabrena, mcp-realweather@jabrena)

Use cases of JBang MCP Examples

• Running a calculator MCP server for demonstration or testing
• Fetching real‑world weather data through an MCP server
• Using a stopwatch MCP server for timing operations
• Deploying MCP servers in Docker containers for production‑like setups
• Building an AI‑powered Java application that consumes MCP tools

FAQ from JBang MCP Examples

What example servers are included?

The repository includes MCPCalculator, MCPRealWeather, and MCPStopWatch servers, each implemented in Java.

How do I run the servers?

Use jbang ./src/main/java/MCPCalculator.java (or the other Java files) or the shorthand jbang mcp-calculator@jabrena. For Docker, use docker build and docker run or docker compose up.

Do I need to install anything to use JBang MCP Examples?

You need a Java SDK (SDKMAN is shown with sdk env) and JBang installed. Maven (via ./mvnw) is used for building and verifying.

Can I run the servers in a container?

Yes. A Dockerfile is provided for MCPStopWatch, and a docker-compose.yml launches all servers. The web UI runs on port 3000.

Where can I find more MCP servers and references?

The README links to a Quarkus MCP JDBC server, the awesome‑mcp‑servers list, the JBang GitHub action, and a Discord channel for MCP discussions.