MCP.so
Sign In

JBang MCP Examples

@jabrena

Repository

About JBang MCP Examples

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

Basic information

Category

Other

License

Apache-2.0

Runtime

java

Transports

stdio

Publisher

jabrena

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.

Comments

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K