Msty Admin MCP

🚀 Msty Admin MCP

基於人工智能的Msty Studio桌面版2.4.0+管理系統

Msty Admin MCP是一個MCP（模型上下文協議）服務器，它能將Claude轉變為Msty Studio桌面版的智能系統管理員。通過自然對話，你可以查詢數據庫、管理配置、編排本地AI模型並構建分層AI工作流。

v9.0.0 - 高級AI編排版本，包含155個工具！新功能包括自主智能體群、智能自動路由、級聯執行、語義緩存、預測性模型加載、A/B測試框架、成本智能儀表盤和動態角色融合。

🚀 快速開始

前提條件

• macOS（推薦使用Apple Silicon）
• Python 3.10+
• 已安裝**Msty Studio桌面版2.4.0+**
• 支持MCP的Claude桌面版

安裝

# 克隆倉庫
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桌面版配置

重要提示：Claude桌面版並不總是遵循cwd設置，因此我們使用一個shell腳本啟動器。

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桌面版（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  # "Based on history, you typically code at 9am"

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+服務支持

📦 安裝指南

克隆倉庫

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桌面版配置

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桌面版（Cmd + Q，然後重新打開）

💻 使用示例

檢查服務狀態

你：我的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”：

        模板："Review this {{language}} code for {{focus}}:

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

                   Provide specific suggestions."

        變量：language, focus, code
        類別：編碼

📚 詳細文檔

可用工具（共155個）

階段1：安裝與健康（7個工具）

階段2：配置管理（4個工具）

階段3：本地模型集成（8個工具）

階段4：智能與分析（5個工具）

階段5：校準與工作流（4個工具）

階段6：高級模型管理（4個工具）

階段7：對話管理（3個工具）

階段8：提示模板與自動化（4個工具）

階段9：備份與系統管理（3個工具）

模型標籤系統

Msty Admin MCP包含一個智能模型標籤系統，具有60多個特定於模型的覆蓋項，用於準確路由。

可用標籤

按標籤查找模型

你：給我找一個快速的編碼模型

Claude：使用find_model_by_tag，標籤為"coding"且prefer_fast=true...

        找到3個快速編碼模型：
        1. deepseek-coder-v2-lite（快速、編碼、小型）
        2. codestral-mini（快速、編碼、小型）
        3. starcoder2-3b（快速、編碼、小型）

智能模型路由器

你：寫一首詩用哪個模型最好？

Claude：使用smart_model_router，任務為"寫一首詩"...

        推薦：claude-3-opus（標籤：質量、創意、推理、大型）
        推理：創意寫作任務受益於具有'創意'標籤和高質量輸出的模型。

環境變量

使用以下環境變量自定義行為：

架構

┌─────────────────────────────────────────────────────────────┐
│                      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      # Shell腳本啟動器（必需！）
├── requirements.txt
├── pyproject.toml
├── CHANGELOG.md
├── LICENSE
└── README.md

文檔鏈接

• API參考 - 錯誤代碼、響應格式、工具參數
• 開發指南 - 貢獻、測試、架構
• 更新日誌 - 版本歷史和遷移說明

🔧 技術細節

安全

詳情請參閱docs/API.md：

• SQL注入防護 - 表白名單、參數化查詢
• API密鑰處理 - 密鑰從不記錄或返回
• 網絡安全 - 所有調用均指向本地主機，可配置超時時間

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE。

關於此分支

👋 你好！我是來自DigitalKredit的Dmitri K。

我接手這個項目時，它只有24個工具，是為舊版Msty Studio架構設計的，當時有一個單獨的“Sidecar”服務，而在Msty 2.4.0+中該服務已不存在。

我所做的工作：

• 🔧 為Msty 2.4.0+重寫代碼庫（服務現在集成到主應用中）
• 🏗️ 重構為簡潔的模塊化架構（30多個模塊）
• 📈 將工具數量從24個擴展到155個全功能工具
• ✅ 添加全面的測試（250多個測試）
• 🚀 構建主要新功能：AI智能體群、智能路由、級聯執行、語義緩存、成本智能等

此分支會針對Msty Studio 2.4.0+進行積極維護和測試。

故障排除

"ModuleNotFoundError: No module named 'src'"

Claude桌面版沒有從正確的目錄運行。請確保使用shell腳本啟動器（run_msty_server.sh），而不是直接調用Python。

"No Local AI services are running"

1. 打開Msty Studio
2. 轉到設置 → 本地AI / MLX / LLaMA.cpp
3. 確保服務顯示“正在運行”

Claude看不到msty-admin工具

1. 檢查你的claude_desktop_config.json是否包含正確的絕對路徑
2. 確保run_msty_server.sh具有可執行權限（chmod +x）
3. 完全重啟Claude桌面版（Cmd + Q，然後重新打開）

只看到2個嵌入模型

顯示的模型取決於哪個服務首先響應。使用list_available_models查看所有服務的所有模型，並按服務進行細分。

未找到數據庫

1. 首先運行detect_msty_installation驗證路徑
2. 使用scan_database_locations查找數據庫文件
3. 如有需要，設置MSTY_DATABASE_PATH環境變量

貢獻

歡迎貢獻代碼！請按以下步驟操作：

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 - 使這一切成為可能的基礎