ibm-mq-mcp

A Go-based MCP (Model Context Protocol) server for IBM MQ management via PCF (Programmable Command Format) commands over stdio.

This repository is designed for AI-assisted IBM MQ work:

• run a local MCP server that talks to your queue manager
• install a shared IBM MQ skill for Codex or Claude
• let the agent automatically reach for the local ibm-mq MCP server when the conversation turns into queue manager, queue, channel, or message work

• 15 IBM MQ tools exposed through MCP
• a shared skill at skills/ibm-mq-mcp/ that can be installed into Codex or Claude
• repo guidance files for Claude (CLAUDE.md) and Codex-style agents (AGENTS.md)
• a project-scoped Claude MCP config in .mcp.json

After building ibm-mq-mcp, you can install the shared skill plus Codex and Claude MCP registrations with one script:

./scripts/install-ai-tooling.sh \
  --mq-install-path "$MQ_INSTALL_PATH" \
  --binary "$(pwd)/ibm-mq-mcp"

Preview only:

./scripts/install-ai-tooling.sh \
  --mq-install-path "$MQ_INSTALL_PATH" \
  --binary "$(pwd)/ibm-mq-mcp" \
  --dry-run

The installer:

• links the shared skill into ~/.codex/skills/ibm-mq-mcp
• links the shared skill into ~/.claude/skills/ibm-mq-mcp
• refreshes the Codex ibm-mq MCP entry
• refreshes the Claude ibm-mq MCP entry

You can limit installation to one tool:

./scripts/install-ai-tooling.sh --mq-install-path "$MQ_INSTALL_PATH" --codex-only
./scripts/install-ai-tooling.sh --mq-install-path "$MQ_INSTALL_PATH" --claude-only

如果你希望 Claude Code 和 Codex 在本地都能直接调用 IBM MQ MCP，最短路径是：

1. 安装 IBM MQ Client，并设置 MQ_INSTALL_PATH=/path/to/ibm-mq
2. 用 mqclient tag 编译真实可连接 MQ 的二进制
3. 运行一键安装脚本，把 skill 和 MCP 注册到本机
4. 重启 Codex，重新开一个 Claude Code 会话

示例：

export MQ_INSTALL_PATH=/path/to/ibm-mq
export CGO_LDFLAGS="-L$MQ_INSTALL_PATH/lib64"
go build -tags mqclient -o ./ibm-mq-mcp ./cmd/ibm-mq-mcp

./scripts/install-ai-tooli