Add it to Claude Code
claude mcp add --transport http max-ref https://maxrefmcp-production.up.railway.app/mcpMake your agent remember this setup
max-ref's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Search and retrieve technical details for Max/MSP objects
- Compare multiple objects and explain connection logic
- Check RNBO compatibility for specific objects
- Access an English-Japanese glossary for Max/MSP terminology
- Search for design patterns and external packages
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 summaryTry it
Original README from dsgarage/MaxRefMCP
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