mcp-jumpserver

MCP server for getting temporary database credentials from JumpServer.

Usage

Claude Code

环境变量可以自己单独维护到系统里

claude mcp add jumpserver \
  -e JUMPSERVER_ACCESS_KEY_ID=your-access-key-id \
  -e JUMPSERVER_ACCESS_KEY_SECRET=your-access-key-secret \
  -e JUMPSERVER_BASE_URL=https://jump.example.com \
  -e JUMPSERVER_ORG_ID=your-org-id \
  -- npx -y @xiaoyuzhzh/mcp-jumpserver

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jumpserver": {
      "command": "npx",
      "args": ["-y", "@xiaoyuzhzh/mcp-jumpserver"],
      "env": {
        "JUMPSERVER_ACCESS_KEY_ID": "your-access-key-id",
        "JUMPSERVER_ACCESS_KEY_SECRET": "your-access-key-secret",
        "JUMPSERVER_BASE_URL": "https://jump.example.com",
        "JUMPSERVER_ORG_ID": "your-org-id"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | JUMPSERVER_ACCESS_KEY_ID | Yes | JumpServer API Access Key ID | | JUMPSERVER_ACCESS_KEY_SECRET | Yes | JumpServer API Access Key Secret | | JUMPSERVER_BASE_URL | Yes | JumpServer base URL (e.g. https://jump.example.com) | | JUMPSERVER_ORG_ID | Yes | JumpServer Organization ID | | JUMPSERVER_BASE_PATH | No | API base path (default: /api/v1) |

Tools

get_jumpserver_db_credentials

Get temporary MySQL connection credentials from JumpServer by asset name.

Input:

| Parameter | Type | Required | Description | |---|---|---|---| | asset_name | string | Yes | Database asset name in JumpServer | | account | string | Yes | Account username | | org_id | string | Yes | Organization ID (from environment variable JUMPSERVER_ORG_ID) |

Output:

• host, port, username, password, database
• expire_time, date_expired
• mysql_command, jdbc_url
• asset_id, asset_name, org_id

License

MIT