返回 MCP 目录
public公开dns本地运行

jumpserver-mcp-server

JumpServer MCP服务是一个基于Docker容器的中间件,用于通过API与JumpServer平台进行交互,支持SSE协议通信。

article

README

🚀 配置JumpServer环境文件(.env)

本项目主要用于配置JumpServer环境文件,并启动相关的Docker容器,同时提供创建JumpServer API携带者令牌以及MCP服务器配置的方法。

🚀 快速开始

📦 安装指南

配置JumpServer环境文件(.env)

在项目中,需要配置JumpServer的环境文件 .env,以下是示例内容:

# 访问JumpServer SWAGGER JSON API的携带者令牌,可选
api_token=xxxxxxx 
jumpserver_url=http://jumpserverhost

请根据实际情况修改 api_tokenjumpserver_url 的值。

启动Docker容器

配置好环境文件后,使用以下命令启动Docker容器:

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

此命令会在后台启动一个名为 jms_mcp 的Docker容器,并将容器的8099端口映射到主机的8099端口。

💻 使用示例

为MCP服务器创建JumpServer API携带者令牌

使用以下脚本为MCP服务器创建JumpServer API携带者令牌:

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 "您的携带者令牌:$TOKEN"

请将 jumpserver_hostusernamepassword 替换为实际的值。

MCP服务器配置

以下是MCP服务器的配置示例:

{
    "type": "sse",
    "url": "http://127.0.0.1:8099/mcp",
    "headers": {
        "Authorization": "Bearer xxxxxxxx"
    }
}

请将 Authorization 字段中的 xxxxxxxx 替换为实际的携带者令牌。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端