JBang MCP Examples

by jabrena

1 stars
166 downloads
Not rated
GitHub

About

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

Details

Author
jabrena
GitHub stars
1
Downloads
166
Categories
Other

- 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)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name JBang MCP Examples
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

JBang MCP Examples

sdk env
./mvnw clean verify

jbang ./src/main/java/MCPCalculator.java
jbang ./src/main/java/MCPRealWeather.java
jbang ./src/main/java/MCPStopWatch.java

jbang mcp-calculator@jabrena
jbang mcp-realweather@jabrena

docker build -t mcp-stopwatch -f Dockerfile .
docker run mcp-stopwatch

docker compose up -d
docker compose down
docker compose logs mcp-calculator
docker compose stats
http://localhost:3000/

jbang ./src/main/java/AIApp.java

./mvnw versions:display-dependency-updates
./mvnw versions:display-plugin-updates
./mvnw versions:display-property-updates

References

- https://github.com/quarkiverse/quarkus-mcp-servers/blob/main/jdbc/README.md
- https://github.com/punkpeye/awesome-mcp-servers
- https://github.com/jbangdev/jbang-action
- https://discord.com/channels/1128867683291627614/1211804431340019753

Powered by Cursor

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.