JumpServer MCP Server

by jumpserver

31 stars
207 downloads
Not rated
GitHub

About

JumpServer MCP Server is a Model Context Protocol server that connects to JumpServer via its Swagger JSON API. It enables large language model clients to interact with JumpServer resources using a Bearer token for authentication.

Details

Author
jumpserver
GitHub stars
31
Downloads
207
Categories
Other

- SSE (Server-Sent Events) transport for real-time communication
- Bearer token authentication via JumpServer API
- Deployable as a lightweight Docker container
- Exposes JumpServer functionality through MCP tools

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 JumpServer MCP Server
    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

Configure an environment file with jumpserver_url and optionally api_token, then run the Docker container using docker run -d -it -p 8099:8099 --env-file .env --name jms_mcp ghcr.io/jumpserver/mcp:latest. Configure the MCP client with SSE transport pointing to http://127.0.0.1:8099/sse and include an Authorization: Bearer <token> header.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "jumpserver mcp server": {
            "mcp-jumpserver": {
                "url": "http://jms_mcp:8099/sse",
                "headers": {
                    "Authorization": "Bearer xxxxxxxx"
                }
            }
        }
    }
}

McpServers

{
    "mcp-jumpserver": {
        "url": "http://jms_mcp:8099/sse",
        "headers": {
            "Authorization": "Bearer xxxxxxxx"
        }
    }
}

JumpServer MCP Server

Configure JumpServer Environment File (.env)

# Bearer token to access the JumpServer Swagger Json API, optional
api_token=xxxxxxx 
jumpserver_url=http://jumpserverhost

Start Docker Container

docker run -d -it -p 8099:8099 --env-file .env --name jms_mcp ghcr.io/jumpserver/mcp:latest

Create JumpServer API Bearer Token for MCP Server


TOKEN=$(curl -s -X POST http://jumpserver_host/api/v1/authentication/auth/ \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin",
    "password": "xxxx"
  }' \
  --insecure | jq -r '.token')

echo "Your Bearer token: $TOKEN"

MCP Server Configuration

{
    "type": "sse",
    "url": "http://127.0.0.1:8099/sse",
    "headers": {
        "Authorization": "Bearer xxxxxxxx"
    }
}
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.