Jolokia MCP Server

Jolokia MCP 服务

适用于 Jolokia 的 MCP 服务。Jolokia 是 Java 应用的 JMX-HTTP 桥接器。此 MCP 服务通过 Jolokia 使用 JMX API 管理 Java 应用，使大模型能够执行此操作。

https://github.com/user-attachments/assets/624ec93b-da69-49b5-be8f-02f2ff14bd2e

发行版

从 0.4 版本开始，Jolokia MCP Server 提供两种不同的发行版，以满足不同的部署需求：

• 独立 MCP 服务
• JVM Agent MCP 服务

独立 MCP 服务

独立 MCP 服务的行为与常规 MCP 服务相同；它通过 stdio 或 HTTP 注册到 MCP 主机，并通过 HTTP 上的 JMX 与 Java 应用通信，而该应用必须附加 Jolokia Agent。

要使用独立 MCP 服务，首先需要为 Java 应用附加 Jolokia Agent。有关具体操作方法的详细说明，请参阅 Jolokia 手册： https://jolokia.org/reference/html/manual/agents.html

JVM Agent MCP 服务

相比之下，JVM Agent MCP 服务是标准 Jolokia JVM Agent 的精简“即插即用”替代品。

使用此发行版时，只需将 MCP 服务的 JVM Agent 附加到应用，而不是标准 Jolokia JVM Agent。随后，JVM Agent MCP 服务会直接开放一个用于 MCP 协议的 HTTP 端口，从而将 Java 应用本身转变为 MCP 服务。

功能

此 MCP 服务会在启动时连接到单个 JVM，并为已连接的 JVM 提供以下功能：

• 列出已连接 JVM 中的 MBean
• 列出 MBean 的操作
• 列出 MBean 的属性
• 读取／写入 MBean 的属性
• 执行 MBean 的操作

工具

此 MCP 服务提供 6 个工具。

• listMBeans
  • 列出 JVM 中可用的 MBean
  • 输出（List<String>）：JVM 中所有 MBean 对象名称的列表
• listMBeanOperations
  • 列出指定 MBean 的可用操作
  • 输入：
    • mbean（String）：MBean 名称
  • 输出（String）：指定 MBean 所有可用操作的 JSON 格式定义
• listMBeanAttributes
  • 列出指定 MBean 的可用属性
  • 输入：
    • mbean（String）：MBean 名称
  • 输出（String）：指定 MBean 所有可用属性的 JSON 格式定义
• readMBeanAttribute
  • 读取指定 MBean 的属性
  • 输入：
    • mbean（String）：MBean 名称
    • attribute（String）：属性名称
  • 输出（String）：指定属性值的字符串表示，或 "null"
• writeMBeanAttribute
  • 设置指定 MBean 属性的值
  • 输入：
    • mbean（String）：MBean 名称
    • attribute（String）：属性名称
    • value（Object）：属性值
  • 输出（String）：指定属性原值的字符串表示，或 "null"
• executeMBeanOperation
  • 执行指定 MBean 的操作
  • 输入：
    • mbean（String）：MBean 名称
    • operation（String）：操作名称
    • args（Object[]）：参数
  • 输出（String）：操作返回值的字符串表示，或 "null"

Jolokia 版本兼容性

下表显示了 jolokia-mcp-server 各版本兼容的 Jolokia 版本。

jolokia-mcp-server	Jolokia
0.6.x	2.6.1 – 2.6.3
0.5.x	2.4.3 – 2.6.0
0.4.x	2.2.9 – 2.4.3
0.3.x	2.2.8 – 2.2.9
0.2.x	2.2.8
0.1.x	2.2.8

安装

独立运行

下载 MCP 服务运行器 jar：

• jolokia-mcp-server-0.6.1-runner.jar

要将 Jolokia MCP 服务安装到 MCP 宿主，请将以下条目添加到 MCP 设置中：

{
  "mcpServers": {
    "jolokia": {
      "command": "java",
      "args": [
        "-jar",
        "<path-to-the-runner-jar>/jolokia-mcp-0.6.1-runner.jar"
      ]
    }
  }
}

或者，如果你更喜欢使用 JBang（此方法无需下载 jar）：

{
  "mcpServers": {
    "jolokia": {
      "command": "jbang",
      "args": [
        "org.jolokia.mcp:jolokia-mcp-server:0.6.1:runner"
      ]
    }
  }
}

JVM Agent

下载 MCP 服务 javaagent jar：

• jolokia-mcp-agent-jvm-0.6.1-javaagent.jar

然后使用 -javaagent 选项运行 Java 应用：

java -javaagent:jolokia-mcp-agent-jvm-0.6.1-javaagent.jar -jar your-app.jar

这将在 http://localhost:8779/mcp 上开放 MCP HTTP 传输端点。

要将 Jolokia MCP 服务注册到 MCP 宿主，请将以下条目添加到 MCP 设置中：

{
  "mcpServers": {
    "jolokia": {
      "httpUrl": "http://localhost:8779/mcp"
    }
  }
}

运行

使用 java -jar 运行：

java -jar jolokia-mcp-server-0.6.1-runner.jar [Jolokia URL]

使用 JBang 时，可以通过 Maven GAV（org.jolokia.mcp:jolokia-mcp-server:0.6.1:runner）直接运行：

jbang org.jolokia.mcp:jolokia-mcp-server:0.6.1:runner

HTTP 传输

默认情况下，此 MCP 服务使用 stdio 传输。要切换到 HTTP 传输，请使用 --http 选项：

java -jar jolokia-mcp-server-0.6.1-runner.jar --http

HTTP 传输端点默认在 http://localhost:8080/mcp 启动。

配置选项

参数/选项	默认值	说明
位置参数	http://localhost:8778/jolokia	MCP 服务连接的 Jolokia 端点 URL
--http	false (stdio)	启用 HTTP 传输
--sse	false (stdio)	已弃用。请使用 --http
--port=<number>	8080	HTTP 端点的端口。等同于 -Dquarkus.http.port=<number>。设置此选项后将始终启用 HTTP
--method=<GET|POST>		Jolokia 请求的首选 HTTP 方法（GET 或 POST）。等同于 -Djolokia.mcp.preferred-http-method=<method>
-D*=*		系统属性

与 MCP 服务相关的系统属性：

系统属性	默认值	说明
quarkus.http.port	8080	（HTTP）HTTP 端点的端口
jolokia.mcp.url	http://localhost:8778/jolokia	等同于位置参数
jolokia.mcp.preferred-http-method	未设置	Jolokia 请求的首选 HTTP 方法（GET 或 POST）

构建

mvn clean install