Mixpeek MCP server

<!-- mcp-name: io.github.mixpeek/mcp-server -->

Mixpeek MCP Server

A lightweight, production-friendly Model Context Protocol (MCP) server for Mixpeek that:

• Auto-loads Mixpeek's OpenAPI spec and exposes endpoints as MCP tools
• Supports local and hosted use (bring-your-own API key)
• Injects Authorization and X-Namespace headers
• Includes rate limits, timeouts, and redacted logs
• Ships with Docker and simple configuration

Quickstart

1. Install

Python (PyPI):

# global (recommended)
pipx install mixpeek-mcp

# or in a venv
python -m venv .venv && source .venv/bin/activate
pip install mixpeek-mcp

npm (Node):

# run once
npx @mixpeek/mcp

# or install globally
npm i -g @mixpeek/mcp

Homebrew (macOS):

# tap and install (once the tap is live)
brew tap mixpeek/tap https://github.com/mixpeek/homebrew-tap
brew install mixpeek-mcp

# temporary local formula (dev/testing):
brew install --build-from-source Formula/mixpeek-mcp.rb

1. Configure (env or your MCP client secret store)

cp env.sample .env
# edit as needed

Env vars:

• MIXPEEKAPIKEY: Your Mixpeek API key (optional if endpoints don't require auth)
• MIXPEEKAPIBASE: Default https://api.mixpeek.com
• MIXPEEKOPENAPIURL: Defaults to /openapi.json (or /docs/openapi.json)
• MIXPEEK_NAMESPACE: Optional namespace value to send via X-Namespace
• MCPRATEMAXCALLS: Default 20 per MCPRATEPERSECONDS
• MCPRATEPER_SECONDS: Default 10
• MCPCONNECTTIMEOUT: Default 5
• MCPREADTIMEOUT: Default 30

1. Run locally (stdio)

# PyPI
mixpeek-mcp

# from source
python server.py

# npm
mixpeek-mcp

Your MCP client (e.g., Claude Desktop) can attach to this server via stdio.

Docker

docker build -t mixpeek-mcp:latest .
docker run --rm -it \
  -e MIXPEEK_API_KEY=sk_... \
  -e MIXPEEK_NAMESPACE=your_namespace \
  mixpeek-mcp:latest

Or pull and run (once published):

docker run --rm -it \
  -e MIXPEEK_API_KEY=sk_... \
  -e MIXPEEK_NAMESPACE=your_namespace \
  ghcr.io/mixpeek/mcp:latest

Distribution

• npm: @mixpeek/mcp → https://www.npmjs.com/package/@mixpeek/mcp
• PyPI: mixpeek-mcp → https://pypi.org/project/mixpeek-mcp/ (publish pending)
• Docker Hub: mixpeek/mcp (pending push), GHCR: ghcr.io/mixpeek/mcp (pending push)
• Homebrew: mixpeek/tap/mixpeek-mcp (tap repo to be created)

Submit to Docker MCP Registry

We prepared registry.json compatible with the Official Docker MCP Registry. To submit:

1. Fork the registry and create a new entry under the appropriate directory per their CONTRIBUTING guide.
2. Include our registry.json (update Docker image reference if you publish under a different org/tag).
3. Open a PR. Upon approval, it will appear in the MCP catalog and Docker Desktop's MCP Toolkit.

Configuration

Required for write-protected endpoints:

• MIXPEEKAPIKEY: Authorization: Bearer

Optional:

• MIXPEEK_NAMESPACE: sets X-Namespace for isolation
• MIXPEEKAPIBASE: defaults to https://api.mixpeek.com; testing: https://server-xb24.onrender.com
• MIXPEEKOPENAPIURL: defaults to /openapi.json (or /docs/openapi.json)
• MCPRATEMAXCALLS / MCPRATEPERSECONDS: simple token bucket
• MCPCONNECTTIMEOUT / MCPREADTIMEOUT: request timeouts

How it works

• Loads OpenAPI spec and maps GET/POST JSON endpoints to tools using operationId
• Tool arguments accept top-level query parameters or a query/body envelope
• Forwards requests to Mixpeek with configured headers
• Provides small allowlist (configurable) and redacts secrets in logs

Testing

Unit tests:

pip install -r requirements.txt
pytest -q

Shortened. The full README is on GitHub.