Skip to content
MCP server

MCP Zmq

MCP server giving AI clients ZeroMQ publish, subscribe, request and reply messaging

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About MCP Zmq

MCP Zmq is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

The README describes mcp-zmq as a Model Context Protocol server that wraps ZeroMQ messaging so an AI client can send and receive messages over ZMQ sockets. It is installed from PyPI and started with a single command, using stdio as its transport.

The server exposes tools that map onto the main ZMQ socket patterns: publishing to a PUB socket, subscribing to a SUB socket, sending requests through a REQ socket, and listening for and answering requests on a REP socket. It also lists tools for connecting and binding PAIR sockets and a status tool for checking the server. The same functions are importable from the Python package for use outside MCP.

The project is aimed at developers who want an assistant or agent to take part in existing ZeroMQ-based message flows. The repository includes test, lint and type-check setup for contributors.

Install

Run in a terminal

claude mcp add mcp-zmq -- uvx mcp-zmq

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-zmq": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

zmq_publish
Publish a message to a ZMQ PUB socket
zmq_subscribe
Subscribe to messages from a ZMQ SUB socket
zmq_send_request
Send a request via ZMQ REQ socket
zmq_listen_reply
Listen for requests and reply via ZMQ REP socket
zmq_pair_connect
Connect to a ZMQ PAIR socket
zmq_pair_bind
Bind a ZMQ PAIR socket
zmq_status
Get ZMQ server status

What it does

Publish and subscribe
Sends messages to a ZMQ PUB socket and reads from a SUB socket.
Request and reply
Supports REQ-side requests and REP-side listening and replies.
PAIR socket connections
Provides tools to connect to or bind a ZMQ PAIR socket.
Stdio MCP transport
Runs as a local MCP server over stdio, installed via pip.
Python API
Exposes the same messaging functions for direct import in Python code.

Good for

  • Letting an AI assistant publish status messages to a ZeroMQ pub/sub system
  • Querying a service that answers over a ZMQ REP socket
  • Monitoring messages arriving on a ZMQ SUB socket
  • Testing ZeroMQ-based components from an MCP client

Pricing

Open source

Open source, installed from PyPI.

MCP Zmq FAQ

How is the server installed?

The README says to install it with pip install mcp-zmq and start it with the mcp-zmq command.

Which ZMQ socket types are supported?

The README lists PUB, SUB, REQ, REP and PAIR socket tools.

Is MCP Zmq free?

Yes. MCP Zmq is open source, so you can use and self-host it for free.

How do I add MCP Zmq to Claude Code?

Run this command in your terminal: claude mcp add mcp-zmq -- uvx mcp-zmq

What are the best alternatives to MCP Zmq?

The closest alternatives to MCP Zmq are MCP Telegram Bot and Zoko MCP by usefulapi.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers