MCP 服务器

MaxRefMCP

Provides a comprehensive reference tool for Max/MSP and Max4Live with Japanese language support, enabling natural language searches for objects, patching patterns, and packages. It allows users to retrieve technical details, glossary terms, and implementation guides directly within Claude Desktop.

README

MaxRefMCP

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	よくある質問