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 - 使这一切成为可能的基础