JBang MCP Examples

@jabrena

About JBang MCP Examples

Learning how to interact with LLM from MCP Servers with JBang, Quarkus & Langchain4j

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "jbang-mcp-examples": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-stopwatch",
        "-f",
        "Dockerfile",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Other MCP servers

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.