MaxRefMCP — Max/MSP リファレンス・設計相談 MCP サーバー

Max/MSP・Max4Live の日本語対応リファレンス・設計相談 MCP サーバー。 Claude Code / Claude Desktop から自然言語でオブジェクト仕様の調査、パッチ設計の壁打ち、学習支援が受けられます。

Claude Code → MaxRefMCP（調べる・学ぶ・設計する）
           → MaxMCP（作る・操る・制御する）  ← 姉妹プロジェクト

ツール一覧

ツール	説明
`maxref.compare_objects`	オブジェクト比較（用途・構成・RNBO互換性を並べて解説）
`maxref.suggest_approach`	実装アプローチ提案（やりたいことから複数案を壁打ち）
`maxref.explain_connection`	接続方法解説（型互換性・推奨接続の判定）
`maxref.rnbo_compatibility`	RNBO互換チェック（非対応時は代替提案）

ツール	説明
`maxref.report_bug`	バグ報告 → GitHub Issue を自動作成（MaxMCP / MaxRefMCP に自動振り分け）
`maxref.request_feature`	機能追加リクエスト → GitHub Issue を自動作成（自動振り分け）

フィードバックツールの利用には環境変数 GITHUB_TOKEN の設定が必要です。未設定の場合は手動作成用の URL が返されます。

ツール	説明
`maxref.analytics`	API利用状況サマリー（ツール別呼び出し数・応答時間・人気クエリ・日別推移）

ダッシュボード: サーバーのルートURLにアクセスするとビジュアルダッシュボードで利用状況を確認できます。

API エンドポイント:

ワークフロー: MaxRefMCP で設計を相談 → MaxMCP で実装

pip install -r requirements.txt
python core.py
# → http://localhost:8000/mcp

.mcp.json または claude_desktop_config.json に追加:

{
  "mcpServers": {
    "max-ref": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

{
  "mcpServers": {
    "max-ref": {
      "url": "https://maxrefmcp-production.up.railway.app/mcp"
    }
  }
}

python -m pytest test_search.py -v

MIT