ibm-mq-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MQ_HOST | No | Listen address (only used for streamable-http or sse transports). | 127.0.0.1 |
| MQ_PORT | No | Listen port (only used for streamable-http or sse transports). | 8000 |
| MQ_TIMEOUT | No | Request timeout in seconds. | 30 |
| MQ_BASE_URL | No | The base URL of the mqweb endpoint. | https://127.0.0.1:9443 |
| MQ_PASSWORD | No | Password for the management API. | admin |
| MQ_USERNAME | No | Username for the management API (requires MQWebAdmin role). | admin |
| MQ_LOG_LEVEL | No | Logging level (e.g., INFO, DEBUG). | INFO |
| MQ_READ_ONLY | No | If 'true', only read-only tools are registered (non-mutating operations). | false |
| MQ_TRANSPORT | No | Transport type: stdio, streamable-http, or sse. | stdio |
| MQ_VERIFY_SSL | No | Whether to verify SSL certificates. Use 'true' or 'false'. | false |
| MQ_MESSAGING_PASSWORD | No | Password for the messaging API. | admin |
| MQ_MESSAGING_USERNAME | No | Username for the messaging API (requires MQWebUser role). | app |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_queue_managersA | 列出 mqweb 服务器上的队列管理器及其运行状态。 |
| get_queue_managerA | 查询单个队列管理器的完整属性与运行状态。 Args: qmgr: 队列管理器名称,例如 QM1 |
| get_installation_infoA | 查询 IBM MQ 的安装名称、版本与平台。 |
| list_queuesA | 列出队列及其当前深度。 Args: qmgr: 队列管理器名称,例如 QM1 name: 队列名过滤,支持通配符,例如 DEV.* 或 * queue_type: 队列类型。qlocal 本地队列(默认)、qalias 别名、qremote 远程、 qmodel 模型队列、queue 表示不限类型 |
| get_queueA | 查询单个队列的全部属性,包含当前深度 curdepth。 Args: qmgr: 队列管理器名称,例如 QM1 name: 队列名称,例如 DEV.QUEUE.1 |
| list_channelsA | 列出通道及其定义。 Args: qmgr: 队列管理器名称,例如 QM1 name: 通道名过滤,支持通配符,例如 DEV.* 或 * |
| get_channelA | 查询单个通道的定义,可选附带运行状态。 Args: qmgr: 队列管理器名称,例如 QM1 name: 通道名称,例如 DEV.APP.SVRCONN include_status: 为 true 时额外查询 CHSTATUS(通道未运行时该查询会返回错误)。 查询失败时 status 字段是 {"error": "..."},而不是错误文本字符串—— 无论成功失败,status 字段始终是对象,便于解析。 |
| list_subscriptionsA | 列出订阅。 Args: qmgr: 队列管理器名称,例如 QM1 name: 订阅名过滤,支持通配符,例如 DEV.* 或 * |
| list_topicsA | 列出主题对象。 Args: qmgr: 队列管理器名称,例如 QM1 name: 主题名过滤,支持通配符,例如 DEV.* 或 * |
| browse_messageA | 浏览队列上的第一条消息,不会移除它。 受 MQ REST API 限制,一次只能看到队首那一条:该接口没有游标分页, 连续调用会反复返回同一条消息。需要遍历整个队列请改用原生 MQ 客户端。 要取走消息(并从队列移除)请用 get_message。 Args: qmgr: 队列管理器名称,例如 QM1 queue: 队列名称,例如 DEV.QUEUE.1 |
| run_mqscA | 对指定队列管理器执行一条纯文本 MQSC 命令。 可执行任意 MQSC,包括修改和删除类命令(如 DELETE QLOCAL、STOP CHANNEL), 请谨慎使用。只需要查询时,优先用 list_queues / get_queue 等专用工具。 Args: qmgr: 队列管理器名称,例如 QM1 mqsc_command: MQSC 命令,例如 DISPLAY QLOCAL(DEV.QUEUE.1) CURDEPTH |
| run_mqsc_jsonA | 以结构化形式执行 MQSC 命令,返回 JSON 而非文本,便于精确解析。 与 run_mqsc 危险性相同:可执行任意 MQSC,包括 command="delete" / "alter" 等修改和删除类命令(如 DELETE QLOCAL 的结构化等价物), 请谨慎使用。只需要查询时,优先用 list_queues / get_queue / list_channels 等专用工具。 Args: qmgr: 队列管理器名称,例如 QM1 command: 动词,如 display / define / alter / delete qualifier: 对象类型,如 qlocal / channel / sub / topic name: 对象名称,支持通配符 *,例如 DEV.QUEUE.1 parameters: 命令参数,例如 {"descr": "订单队列"} response_parameters: 只返回这些属性,例如 ["curdepth"] |
| get_messageA | 取走队列上的第一条消息,消息会从队列中被移除,无法撤销。 只想查看内容而不移除,请用 browse_message。 Args: qmgr: 队列管理器名称,例如 QM1 queue: 队列名称,例如 DEV.QUEUE.1 |
| put_messageB | 向队列发送一条文本消息。 Args: qmgr: 队列管理器名称,例如 QM1 queue: 队列名称,例如 DEV.QUEUE.1 body: 消息正文 |
| publish_messageA | 向主题发布一条文本消息。 Args: qmgr: 队列管理器名称,例如 QM1 topic: 主题字符串,例如 dev/sensor body: 消息正文 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Most tools cleanly separate list/get operations for each resource and message actions are clearly distinct. The main overlap is run_mqsc vs run_mqsc_json, which both execute MQSC but differ by output format and argument style; their descriptions mitigate but do not eliminate potential misselection.
All tools use consistent snake_case verb_noun naming: list_* for enumerations, get_* for single-object retrievals, and action_message for messaging operations. The run_mqsc / run_mqsc_json pair follows a clear pattern with a format suffix.
15 tools form a well-scoped administration and messaging surface for IBM MQ: resource queries, message operations, and a generic MQSC escape hatch. Every tool serves a plausible purpose without bloat.
The domain is broadly covered: queue managers, queues, channels, subscriptions, topics, messages, and installation info all have query tools, with message put/get/publish/browse operations present. Minor gaps exist—no dedicated get_subscription or get_topic, no direct create/update/delete tools, and browse_message lacks pagination—but run_mqsc fills most gaps.