Mixpeek

Mixpeek MCP サーバー

Mixpeek 向けの軽量で本番環境に適した Model Context Protocol（MCP）サーバーです。次の機能を備えています。

• Mixpeek の OpenAPI 仕様を自動で読み込み、エンドポイントを MCP ツールとして公開します
• ローカルでの利用とホスト環境での利用に対応します（API キーは各自で用意）
• Authorization ヘッダーと X-Namespace ヘッダーを挿入します
• レート制限、タイムアウト、ログ内の機密情報のマスキングに対応します
• Docker と簡単な設定を用意しています

クイックスタート

1. インストール

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

2. 設定（環境変数、または MCP クライアントのシークレットストア）

cp env.sample .env
# edit as needed

環境変数：

• MIXPEEK_API_KEY：Mixpeek API キーです（エンドポイントで認証が不要な場合は省略可能）
• MIXPEEK_API_BASE：デフォルトは https://api.mixpeek.com です
• MIXPEEK_OPENAPI_URL：デフォルトは <API_BASE>/openapi.json（または /docs/openapi.json）です
• MIXPEEK_NAMESPACE：X-Namespace で送信する名前空間の値です（任意）
• MCP_RATE_MAX_CALLS：MCP_RATE_PER_SECONDS あたりのデフォルト値は 20 です
• MCP_RATE_PER_SECONDS：デフォルトは 10 です
• MCP_CONNECT_TIMEOUT：デフォルトは 5 です
• MCP_READ_TIMEOUT：デフォルトは 30 です

3. ローカルで実行（stdio）

# PyPI
mixpeek-mcp

# from source
python server.py

# npm
mixpeek-mcp

MCP クライアント（Claude Desktop など）は、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

または、公開後にプルして実行します。

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

配布

• npm：@mixpeek/mcp → https://www.npmjs.com/package/@mixpeek/mcp
• PyPI：mixpeek-mcp → https://pypi.org/project/mixpeek-mcp/（公開準備中）
• Docker Hub：mixpeek/mcp（プッシュ待ち）、GHCR：ghcr.io/mixpeek/mcp（プッシュ待ち）
• Homebrew：mixpeek/tap/mixpeek-mcp（tap リポジトリ作成予定）

Docker MCP Registry への登録

公式 Docker MCP Registry と互換性のある registry.json を用意しました。登録するには：

1. Registry をフォークし、CONTRIBUTING ガイドに従って適切なディレクトリに新しいエントリを作成します。
2. registry.json を含めます（別の組織名やタグで公開する場合は、Docker イメージの参照を更新してください）。
3. PR を作成します。承認されると、MCP カタログと Docker Desktop の MCP Toolkit に表示されます。

設定

書き込み保護されたエンドポイントで必要：

• MIXPEEK_API_KEY：Authorization: Bearer <key>

任意：

• MIXPEEK_NAMESPACE：分離用に X-Namespace を設定します
• MIXPEEK_API_BASE：デフォルトは https://api.mixpeek.com です。テスト用：https://server-xb24.onrender.com
• MIXPEEK_OPENAPI_URL：デフォルトは <API_BASE>/openapi.json（または /docs/openapi.json）です
• MCP_RATE_MAX_CALLS / MCP_RATE_PER_SECONDS：簡易トークンバケット
• MCP_CONNECT_TIMEOUT / MCP_READ_TIMEOUT：リクエストのタイムアウト

仕組み

• OpenAPI 仕様を読み込み、operationId を使用して GET/POST の JSON エンドポイントをツールにマッピングします
• ツール引数では、トップレベルのクエリパラメーター、または query / body エンベロープを指定できます
• 設定済みのヘッダーを付けてリクエストを Mixpeek に転送します
• 小規模な許可リスト（設定可能）を提供し、ログ内の機密情報をマスキングします

テスト

ユニットテスト：

pip install -r requirements.txt
pytest -q

ライブテスト（任意）：

export LIVE_MIXPEEK_API_KEY=sk_...
export LIVE_MIXPEEK_OPENAPI_URL=https://server-xb24.onrender.com/docs/openapi.json
export LIVE_MIXPEEK_API_BASE=https://server-xb24.onrender.com
pytest -q tests/test_live_integration.py

MCP クライアントでの使用

• このサーバーは MCP stdio トランスポートと公式サーバーインターフェースを使用しており、一般的な MCP クライアントと互換性があります。
• サーバーを起動し、MCP クライアントに stdio コマンド（mixpeek-mcp）を指定します。

参考資料

• Mixpeek ドキュメント：https://docs.mixpeek.com/overview/introduction
• Mixpeek OpenAPI：https://api.mixpeek.com/docs/openapi.json
• MCP の概要：https://modelcontextprotocol.io/docs/getting-started/intro

注意事項

• 本番環境でホストする場合は、HTTPS の背後に配置し、SSO／セッション発行、テナントごとのレート制限、本文やヘッダーを含まない監査ログを追加してください。デフォルトではローカル stdio を使用し、ホスト環境での HTTP/SSE は後から追加できます。