**mcp-zmq** — MCP server for ZMQ messaging

[![PyPI](https://img.shields.io/pypi/v/mcp-zmq.svg)](https://pypi.org/project/mcp-zmq/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-zmq.svg)](https://pypi.org/project/mcp-zmq/)
[![Coverage](https://codecov.io/gh/daedalus/mcp-zmq/branch/main/graph/badge.svg)](https://codecov.io/gh/daedalus/mcp-zmq)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

mcp-name: io.github.daedalus/mcp-zmq

## Install

```bash
pip install mcp-zmq
```

## Usage

### MCP Server

```bash
mcp-zmq
```

### Python API

```python
from mcp_zmq import zmq_publish, zmq_subscribe, zmq_send_request, zmq_listen_reply
```

## Available Tools

- `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

## Development

```bash
git clone https://github.com/daedalus/mcp-zmq.git
cd mcp-zmq
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```