MaxRefMCP

MaxRefMCP

Provides Japanese-optimized reference, design consultation, and learning support for Max/MSP and Max4Live through natural language queries.

Category
Visit Server

README

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

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

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

ツール一覧

リファレンス検索（5ツール）

ツール 説明
maxref.search_object オブジェクト検索（名前・タグ・日本語キーワード）
maxref.get_object オブジェクト詳細（インレット/アウトレット・仕様書）
maxref.search_pattern パッチパターン検索（やりたいことを自然言語で）
maxref.search_package パッケージ・ライブラリ検索
maxref.glossary 用語集検索（日英対応）

設計相談（4ツール）

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

フィードバック（2ツール）

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

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

アナリティクス（1ツール + ダッシュボード）

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

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

  • ローカル: http://localhost:8000/
  • 本番: https://maxrefmcp-production.up.railway.app/

API エンドポイント:

  • GET /analytics/summary?days=30 — 集計サマリー（JSON）
  • GET /analytics/recent?limit=50 — 直近の呼び出し履歴（JSON）

MaxMCP との使い分け

MaxRefMCP（本サーバー） MaxMCP
一言で 頭を使う 手を動かす
役割 リファレンス・設計相談・学習 パッチ構築・操作・制御
接続 スタンドアロン Max 9 にWebSocket接続
発話例 「cycle~ と phasor~ の違いは？」 「減算シンセを作って」

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

セットアップ

ローカル起動

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

Claude Code / Claude Desktop で使う

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

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

Railway デプロイ

  1. railway.app でアカウント作成（GitHub連携推奨）
  2. Railway CLI インストール: npm i -g @railway/cli && railway login
  3. このリポジトリを GitHub に push
  4. Railway Dashboard → New Project → Deploy from GitHub repo
  5. デプロイ完了後、Settings → Networking → Generate Domain で URL 取得
{
  "mcpServers": {
    "max-ref": {
      "url": "https://maxrefmcp-production.up.railway.app/mcp"
    }
  }
}

テスト

python -m pytest test_search.py -v

データソース

  • object-db.json — 128 オブジェクト（MSP/Max/Jitter）
  • pattern-db.json — 17 パッチパターン
  • package-db.json — 14 パッケージ
  • glossary-db.json — 36 用語（日英対応）

ライセンス

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured