README.md
Max/MSP and Max4Live reference MCP server with Japanese language support
MaxRefMCP
English | 日本語
Max/MSP・Max4Live 日本語リファレンス MCP サーバー
AI から Max/MSP のオブジェクトリファレンスを日本語で検索・参照できる MCP (Model Context Protocol) サーバーです。
MCP をサポートする AI クライアントであればどれでも利用できます。 Claude Code、Claude Desktop をはじめ、MCP の Streamable HTTP トランスポートに対応したクライアントであればそのまま接続可能です。
機能
| ツール | 説明 |
|---|---|
maxref.search_object |
オブジェクト名やキーワードで検索 |
maxref.get_object |
オブジェクトの詳細リファレンス取得 |
maxref.compare_objects |
2〜5 個のオブジェクトを比較 |
maxref.explain_connection |
2 オブジェクト間の接続方法を解説 |
maxref.rnbo_compatibility |
RNBO 互換性チェック＋代替提案 |
maxref.glossary |
Max/MSP 用語の日英辞書 |
maxref.search_pattern |
やりたいことから設計パターンを検索 |
maxref.search_package |
外部パッケージ・ライブラリ検索 |
maxref.suggest_approach |
実装アプローチの提案・壁打ち |
maxref.official_news |
Cycling '74 公式サイトの最新ニュース取得 |
maxref.rnbo_news |
RNBO / Move Takeover の最新情報取得 |
maxref.read_article |
公式記事の詳細読み込み |
maxref.report_bug |
バグ報告 → GitHub Issue 自動作成 |
maxref.request_feature |
機能リクエスト → GitHub Issue 自動作成 |
maxref.analytics |
API 利用状況サマリー取得 |
各ツールの詳細なパラメータ仕様は Wiki — ツールリファレンス をご覧ください。
クイックスタート
Claude Code（CLI）
claude mcp add --transport http --scope project max-ref "https://maxrefmcp-production.up.railway.app/mcp"
Claude Desktop
claude_desktop_config.json に追加:
{
"mcpServers": {
"max-ref": {
"type": "streamable-http",
"url": "https://maxrefmcp-production.up.railway.app/mcp"
}
}
}
その他の MCP 対応クライアント
以下の情報で接続できます:
| 項目 | 値 |
|---|---|
| エンドポイント URL | https://maxrefmcp-production.up.railway.app/mcp |
| トランスポート | Streamable HTTP |
| 認証 | 不要 |
詳しいセットアップ手順は Wiki — セットアップガイド をご覧ください。
使い方
接続後、AI に Max/MSP について質問するだけで自動的にツールが呼び出されます。
「cycle~ と phasor~ の違いを教えて」
「FM 合成のパッチ設計を相談したい」
「gen~ で使えるオブジェクトを検索して」
「groove~ は RNBO で使える？」
活用例は Wiki — 使い方・活用例 をご覧ください。
ドキュメント
| ページ | 内容 |
|---|---|
| セットアップガイド | 各 AI クライアントへの導入方法 |
| ツールリファレンス | 全 15 ツールのパラメータ仕様 |
| 使い方・活用例 | 実際の使い方と質問例 |
| FAQ | よくある質問 |
フィードバック
- バグ報告: Issue を作成
- 機能リクエスト: Issue を作成
- MCP ツール内から
maxref.report_bug/maxref.request_featureで直接報告することもできます
リリースノート
Releases をご覧ください。
関連プロジェクト
- MaxMCP — Max/MSP パッチの実操作（作成・接続・制御）を行う MCP サーバー
MaxRefMCP（調査・設計）と MaxMCP（パッチ操作）を両方接続すると、調査から実装まで一気通貫で AI と協業できます。
作者
dsgarage — @dsgarage
ライセンス
MIT
Tools (15)
maxref.search_objectSearch for objects by name or keywordmaxref.get_objectRetrieve detailed reference for a specific objectmaxref.compare_objectsCompare 2 to 5 objectsmaxref.explain_connectionExplain how to connect two objectsmaxref.rnbo_compatibilityCheck RNBO compatibility and suggest alternativesmaxref.glossaryAccess the Max/MSP English-Japanese glossarymaxref.search_patternSearch for design patterns based on implementation goalsmaxref.search_packageSearch for external packages and librariesmaxref.suggest_approachGet suggestions for implementation approachesmaxref.official_newsGet latest news from Cycling '74maxref.rnbo_newsGet latest RNBO and Move Takeover informationmaxref.read_articleRead detailed official articlesmaxref.report_bugReport a bug via GitHub issuemaxref.request_featureRequest a feature via GitHub issuemaxref.analyticsGet API usage summaryConfiguration
claude_desktop_config.json
{"mcpServers": {"max-ref": {"type": "streamable-http", "url": "https://maxrefmcp-production.up.railway.app/mcp"}}}Try it
→What is the difference between cycle~ and phasor~?
→I want to discuss a patch design for FM synthesis.
→Search for objects I can use in gen~.
→Is the groove~ object compatible with RNBO?