Msty Admin MCP

🚀 Msty Admin MCP

AIによるMsty Studio Desktop 2.4.0+の管理を実現するシステム

Msty Studio DesktopのためのMCP（Model Context Protocol）サーバーです。Claudeをインテリジェントなシステム管理者に変え、自然な会話を通じてデータベースのクエリ、設定の管理、ローカルAIモデルのオーケストレーション、階層的なAIワークフローの構築などを行うことができます。

v9.0.0 - 155のツールを備えた高度なAIオーケストレーション機能を搭載したリリースです！新機能には、自律エージェント群、インテリジェントな自動ルーター、カスケード実行、セマンティックキャッシュ、予測モデルロード、A/Bテストフレームワーク、コストインテリジェンスダッシュボード、動的ペルソナ融合などが含まれます。

🚀 クイックスタート

前提条件

• macOS（Apple Siliconが推奨）
• Python 3.10以上
• Msty Studio Desktop 2.4.0+ がインストールされていること
• MCP対応の Claude Desktop

インストール

# リポジトリをクローン
git clone https://github.com/DBSS/msty-admin-mcp.git
cd msty-admin-mcp

# 仮想環境を作成
python -m venv .venv
source .venv/bin/activate

# 依存関係をインストール
pip install -r requirements.txt

Claude Desktopの設定

重要: Claude Desktopは必ずしも cwd 設定を尊重しないため、シェルスクリプトランチャーを使用します。

1. リポジトリには run_msty_server.sh が含まれています。実行可能にする必要があります。

   chmod +x run_msty_server.sh
   

2. ~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します。

   {
     "mcpServers": {
       "msty-admin": {
         "command": "/absolute/path/to/msty-admin-mcp/run_msty_server.sh",
         "env": {
           "MSTY_TIMEOUT": "30"
         }
       }
     }
   }
   

3. Claude Desktopを再起動 します（Cmd+Qで閉じてから再開）。

4. 利用可能なツールに "msty-admin" が表示され、155のツール が読み込まれているはずです。

✨ 主な機能

v9.0.0の新機能

高度なAIオーケストレーション - 10の新フェーズで42の新ツール

新モジュール (v9.0.0)

主要機能の使用例

🤖 エージェント群 - 専用エージェント（コード、調査、執筆、分析）を生成して並列で動作させ、結果を統合します。

swarm_spawn "Build a comprehensive analysis of this codebase"

🎯 カスケード実行 - 高速なモデルから始め、必要な場合にのみ高性能なモデルにエスカレートします。

cascade_smart "Complex reasoning task requiring detailed analysis"

💰 コストインテリジェンス - 支出を追跡し、ローカルとクラウドを比較し、最適化のアドバイスを取得します。

cost_compare_local_cloud  # ローカルモデルを使用すると95%以上の節約ができることを示します

🔮 予測ロード - 使用パターンを学習し、モデルを事前に読み込みます。

predict_session_start  # "過去の履歴から、通常は午前9時にコーディングを行っています"

v8.0.0の新機能

10の新フェーズで36の新ツール

新モジュール (v8.0.0)

包括的なテスト

• 130以上のユニットテスト がすべてのモジュールをカバー
• PIIパターン検出の検証
• コサイン類似度の数学的テスト
• メンテナンスのドライラン検証

v7.0.0の新機能

6つのフェーズで35のツール

強化されたタグシステムv2.0

• コンテキスト長の認識: long_context (100K以上), very_long_context (250K以上), massive_context (500K以上)
• 量子化検出: fp16, 8bit, 6bit, 5bit, 4bit, 3bit
• アーキテクチャタグ: moe, mlx, gguf
• 新しいサイズ階層: massive (200B以上のパラメータ)

Msty 2.4.0+サービスサポート

💻 使用例

サービスの状態を確認

あなた: 私のMstyサービスの状態はどうですか？

Claude: すべての4つのサービスが稼働しています。
        ✅ ローカルAIサービス (ポート11964) - 2つのモデル
        ✅ MLXサービス (ポート11973) - 11のモデル
        ✅ LLaMA.cppサービス (ポート11454) - 10のモデル
        ✅ Vibe CLIプロキシ (ポート8317) - 36のモデル

        合計: 59のモデルが利用可能

モデルのベンチマークを実行

あなた: 最も高速なコーディングモデルのベンチマークを実行してください。

Claude: deepseek-coder-v2-liteでベンチマークを実行しています...

        結果 (それぞれ3回実行):
        | コンテキスト | トークン/秒 | レイテンシー |
        |---------|------------|---------|
        | 50トークン | 42.3 t/s | 1.2s |
        | 200トークン | 38.7 t/s | 5.2s |
        | 500トークン | 35.1 t/s | 14.3s |

        平均: 38.7トークン/秒

会話をエクスポート

あなた: 先週の会話をMarkdown形式でエクスポートしてください。

Claude: 過去7日間の23の会話をエクスポートしました。

        ファイル: conversations_2026-01-26.md
        形式: 会話ごとにヘッダーを持つMarkdown
        総メッセージ数: 156

プロンプトテンプレートを作成

あなた: コードレビューのテンプレートを作成してください。

Claude: テンプレート "code-review" を作成しました。

        テンプレート: "この {{language}} コードを {{focus}} の観点からレビューしてください。

                   ```{{language}}
                   {{code}}
                   ```

                   具体的な提案を提供してください。"

        変数: language, focus, code
        カテゴリ: コーディング

📚 詳細ドキュメント

• APIリファレンス - エラーコード、レスポンス形式、ツールパラメータ
• 開発ガイド - 貢献方法、テスト、アーキテクチャ
• 変更履歴 - バージョン履歴と移行ノート

🔧 技術詳細

モデルタグシステム

Msty Admin MCPには、正確なルーティングのための60以上のモデル固有のオーバーライドを持つスマートモデルタグシステムが含まれています。

利用可能なタグ

タグでモデルを検索

あなた: 高速なコーディングモデルを探してください。

Claude: find_model_by_tagを使用して、タグ="coding" かつ prefer_fast=true で検索しています...

        3つの高速なコーディングモデルが見つかりました。
        1. deepseek-coder-v2-lite (fast, coding, small)
        2. codestral-mini (fast, coding, small)
        3. starcoder2-3b (fast, coding, small)

スマートモデルルーター

あなた: 詩を書くのに最適なモデルは何ですか？

Claude: smart_model_routerを使用して、タスク="詩を書く" で検索しています...

        推奨: claude-3-opus (タグ: quality, creative, reasoning, large)
        理由: クリエイティブな執筆タスクは、'creative' タグを持ち、高品質な出力をするモデルが適しています。

環境変数

以下の環境変数を使用して動作をカスタマイズできます。

アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                      Claude Desktop                          │
│                           │                                  │
│                      MCP Protocol                            │
│                           │                                  │
│                ┌──────────┴──────────┐                      │
│                ▼                     ▼                      │
│      ┌─────────────────┐   ┌─────────────────┐             │
│      │ Msty Admin MCP  │   │  Other MCPs     │             │
│      │   (42 tools)    │   │                 │             │
│      └────────┬────────┘   └─────────────────┘             │
└───────────────┼─────────────────────────────────────────────┘
                │
     ┌──────────┴──────────────────────────────┐
     ▼                                         ▼
┌──────────┐                          ┌──────────────────┐
│  Msty    │                          │   Msty Studio    │
│ Database │                          │   2.4.0+ App     │
│ (SQLite) │                          └────────┬─────────┘
└──────────┘                                   │
                          ┌────────────────────┼────────────────────┐
                          ▼                    ▼                    ▼
                   ┌────────────┐      ┌────────────┐      ┌────────────┐
                   │ Local AI   │      │    MLX     │      │ LLaMA.cpp  │
                   │  :11964    │      │   :11973   │      │   :11454   │
                   └────────────┘      └────────────┘      └────────────┘
                          │                    │                    │
                          └────────────────────┼────────────────────┘
                                               ▼
                                        ┌────────────┐
                                        │ Vibe Proxy │
                                        │   :8317    │
                                        └────────────┘

プロジェクト構造

msty-admin-mcp/
├── src/
│   ├── __init__.py         # パッケージエクスポート
│   ├── constants.py        # 設定定数
│   ├── models.py           # データクラス
│   ├── errors.py           # 標準化されたエラーハンドリング
│   ├── paths.py            # パス解決ユーティリティ
│   ├── database.py         # SQL操作 (インジェクション保護済み)
│   ├── network.py          # APIリクエストヘルパー
│   ├── cache.py            # 応答キャッシュ
│   ├── tagging.py          # モデルタグシステム
│   ├── server.py           # メインMCPサーバー (42のツール)
│   └── phase4_5_tools.py   # メトリクスとキャリブレーション
├── tests/
│   ├── test_server.py      # 統合テスト
│   ├── test_constants.py   # 定数テスト
│   ├── test_paths.py       # パスユーティリティテスト
│   ├── test_database.py    # データベーステスト (SQLインジェクション)
│   ├── test_network.py     # ネットワークテスト
│   ├── test_cache.py       # キャッシュテスト
│   └── test_tagging.py     # タグシステムテスト
├── docs/
│   ├── API.md              # APIリファレンスとエラーコード
│   └── DEVELOPMENT.md      # 開発ガイド
├── run_msty_server.sh      # シェルスクリプトランチャー (必須!)
├── requirements.txt
├── pyproject.toml
├── CHANGELOG.md
├── LICENSE
└── README.md

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。

トラブルシューティング

"ModuleNotFoundError: No module named 'src'"

Claude Desktopが正しいディレクトリから実行されていません。Pythonを直接呼び出すのではなく、シェルスクリプトランチャー (run_msty_server.sh) を使用していることを確認してください。

"No Local AI services are running"

1. Msty Studioを開きます。
2. 設定 → ローカルAI / MLX / LLaMA.cppに移動します。
3. サービスが "Running" と表示されていることを確認します。

Claudeがmsty-adminツールを認識しない

1. claude_desktop_config.json に正しい絶対パスが設定されていることを確認します。
2. run_msty_server.sh が実行可能であることを確認します (chmod +x)。
3. Claude Desktopを完全に再起動します（Cmd+Qで閉じてから再開）。

2つの埋め込みモデルしか表示されない

表示されるモデルは、最初に応答したサービスに依存します。list_available_models を使用して、すべてのサービスからのすべてのモデルを by_service の内訳で表示してください。

データベースが見つからない

1. まず detect_msty_installation を実行してパスを検証します。
2. scan_database_locations を使用してデータベースファイルを検索します。
3. 必要に応じて MSTY_DATABASE_PATH 環境変数を設定します。

セキュリティ

詳細については docs/API.md を参照してください。

• SQLインジェクション保護 - テーブル許可リスト、パラメータ化されたクエリ
• APIキーの取り扱い - キーは決してログに記録されたり返されたりすることはありません。
• ネットワークセキュリティ - すべての呼び出しはローカルホストに対して行われ、タイムアウトを設定可能です。

貢献方法

貢献を歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. テストを実行します (pytest tests/ -v)。
4. 変更をコミットします (git commit -m 'Add amazing feature')。
5. ブランチにプッシュします (git push origin feature/amazing-feature)。
6. プルリクエストを作成します。

詳細な貢献ガイドについては docs/DEVELOPMENT.md を参照してください。

クレジット

• オリジナル作者: Pineapple - 元のmsty-admin-mcpを作成
• v5.0.0以降のフォーク: DigitalKredit - Msty 2.4.0+互換性、モジュール化アーキテクチャ

謝辞

• Msty Studio - このMCPが管理する優れたローカルAIアプリケーション
• Anthropic - ClaudeとMCPプロトコルの提供
• Model Context Protocol - このシステムを可能にする基盤