JBang MCP Examples

@jabrena

Basic information

About JBang MCP Examples

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

JBang MCP Examples 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",
        "."
      ]
    }
  }
}

JBang MCP Examples tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea