Msty Admin MCP

Msty管理员MCP

Msty Studio桌面的人工智能管理2.4.0+

MCP（模型上下文协议）服务器，将Claude转换为智能系统管理员，用于 Msty工作室桌面.查询数据库、管理配置、编排本地AI模型和构建分层AI工作流程——所有这些都是通过自然对话完成的。

](https://github.com/DBSS/msty-admin-mcp/releases)      

v9.0.0版本 -配备155个工具的高级AI编排版本！新功能包括自主代理Swarms、智能自动路由器、级联执行、语义缓存、预测模型加载、A/B测试框架、成本智能仪表板和动态人物融合。

______________________________________________________________________

关于这个叉子

👋 嘿！我是Dmitri K DigitalKredit.

我拿起这个项目时，它已经 24工具 专为较旧的Msty Studio架构而设计，具有Msty 2.4.0+中不再存在的单独“Sidecar”服务。

我做了什么：

• 🔧 重写代码库 适用于Msty 2.4.0+（服务现已内置于主应用程序中）
• 🏗️ 重构 转换为干净的模块化架构（30+个模块）
• 📈 扩展的 从24种工具到 155个功能齐全的工具
• ✅ 增加了全面的测试 （250+次测试）
• 🚀 构建了主要的新功能：AI代理集群、智能路由、级联执行、语义缓存、成本智能等

此分支已针对Msty Studio 2.4.0+进行了积极维护和测试。

______________________________________________________________________

v9.0.0的新增功能

高级AI编排-10个新阶段的42个新工具

新模块（v9.0.0）

主要特点

🤖 智能体集群 -Spawn专业代理（代码、研究、写作、分析）并行工作并综合结果：

swarm_spawn "Build a comprehensive analysis of this codebase"

🎯 级联执行 -从快速型号开始，只在需要时升级到功能强大的型号：

cascade_smart "Complex reasoning task requiring detailed analysis"

💰 成本情报 -跟踪支出，比较本地与云，获取优化提示：

cost_compare_local_cloud  # Shows 95%+ savings using local models

🔮 预测性加载 -了解您的使用模式和预热模式：

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

______________________________________________________________________

这是什么？

Msty Admin MCP允许您通过Claude Desktop管理整个Msty Studio安装。与其点击菜单或手动编辑配置文件，不如问Claude：

“向我展示我的Msty角色并提出改进建议”

“在编码任务中比较我的本地模型”

“我在所有服务中都有哪些可用的型号？”

“对我最快的编码任务模型进行基准测试”

Claude负责其余的工作——查询数据库、调用API、分析结果和提供可操作的见解。

______________________________________________________________________

快速开始

先决条件

• macOS （推荐苹果硅）
• Python 3.10+
• Msty Studio桌面2.4.0+ 安装
• 克劳德桌面版 支持MCP

安装

# Clone the repository
git clone https://github.com/DBSS/msty-admin-mcp.git
cd msty-admin-mcp

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Claude桌面配置

重要：Claude Desktop并不总是尊重 cwd 设置，因此我们使用shell脚本启动器。

1. 存储库包括 run_msty_server.sh。确保它是可执行的：

   chmod +x run_msty_server.sh

1. 增添 ~/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"
         }
       }
     }
   }

1. 重新启动克劳德桌面 （Cmd+Q，然后重新打开）

1. 您应该在可用的工具中看到“msty-admin” 155工具 加载。

______________________________________________________________________

可用工具（共155个）

第一阶段：安装和健康（7个工具）

第2阶段：配置管理（4个工具）

第3阶段：本地模型集成（8个工具）

第四阶段：情报与分析（5个工具）

第5阶段：校准和工作流程（4个工具）

第6阶段：高级模型管理（4个工具）

第7阶段：对话管理（3个工具）

第8阶段：提示模板和自动化（4个工具）

第9阶段：备份和系统管理（3个工具）

______________________________________________________________________

模型标记系统

Msty Admin MCP包括一个智能模型标记系统，该系统具有60多个特定于模型的覆盖功能，可实现精确的布线。

可用标签

按标签查找模型

You: Find me a fast coding model

Claude: Using find_model_by_tag with tag="coding" and prefer_fast=true...

        Found 3 fast coding models:
        1. deepseek-coder-v2-lite (fast, coding, small)
        2. codestral-mini (fast, coding, small)
        3. starcoder2-3b (fast, coding, small)

智能模型路由器

You: What's the best model for writing a poem?

Claude: Using smart_model_router with task="writing a poem"...

        Recommended: claude-3-opus (tags: quality, creative, reasoning, large)
        Reasoning: Creative writing tasks benefit from models with
        the 'creative' tag and high quality output.

______________________________________________________________________

使用示例

检查服务状态

You: What's the status of my Msty services?

Claude: All 4 services are running:
        ✅ Local AI Service (port 11964) - 2 models
        ✅ MLX Service (port 11973) - 11 models
        ✅ LLaMA.cpp Service (port 11454) - 10 models
        ✅ Vibe CLI Proxy (port 8317) - 36 models

        Total: 59 models available

对模型进行基准测试

You: Benchmark my fastest coding model

Claude: Running benchmark on deepseek-coder-v2-lite...

        Results (3 runs each):
        | Context | Tokens/sec | Latency |
        |---------|------------|---------|
        | 50 tokens | 42.3 t/s | 1.2s |
        | 200 tokens | 38.7 t/s | 5.2s |
        | 500 tokens | 35.1 t/s | 14.3s |

        Average: 38.7 tokens/sec

导出对话

You: Export my last week's conversations to markdown

Claude: Exported 23 conversations from the last 7 days.

        File: conversations_2026-01-26.md
        Format: Markdown with headers per conversation
        Total messages: 156

创建提示模板

You: Create a code review template

Claude: Created template "code-review":

        Template: "Review this {{language}} code for {{focus}}:

{{code}}

                   Provide specific suggestions."

        Variables: language, focus, code
        Category: coding

______________________________________________________________________

环境变量

使用以下环境变量自定义行为：

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────────────────┐
│                      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         # Package exports
│   ├── constants.py        # Configuration constants
│   ├── models.py           # Data classes
│   ├── errors.py           # Standardized error handling
│   ├── paths.py            # Path resolution utilities
│   ├── database.py         # SQL operations (injection protected)
│   ├── network.py          # API request helpers
│   ├── cache.py            # Response caching
│   ├── tagging.py          # Model tagging system
│   ├── server.py           # Main MCP server (42 tools)
│   └── phase4_5_tools.py   # Metrics and calibration
├── tests/
│   ├── test_server.py      # Integration tests
│   ├── test_constants.py   # Constants tests
│   ├── test_paths.py       # Path utilities tests
│   ├── test_database.py    # Database tests (SQL injection)
│   ├── test_network.py     # Network tests
│   ├── test_cache.py       # Cache tests
│   └── test_tagging.py     # Tagging tests
├── docs/
│   ├── API.md              # API reference & error codes
│   └── DEVELOPMENT.md      # Development guide
├── run_msty_server.sh      # Shell script launcher (required!)
├── requirements.txt
├── pyproject.toml
├── CHANGELOG.md
├── LICENSE
└── README.md

______________________________________________________________________

文档

• api参考 -错误代码、响应格式、工具参数
• 开发指南 -贡献、测试、架构
• 更新日志 -版本历史和迁移说明

______________________________________________________________________

故障排除

“ModuleNotFoundError:没有名为'src'的模块”

Claude Desktop未从正确的目录运行。确保您使用的是shell脚本启动器(run_msty_server.sh)而不是直接调用Python。

“没有本地AI服务正在运行”

1. 打开Msty工作室
2. 转到“设置”→ 本地AI/MLX/LLaMA.cpp
3. 确保服务显示“正在运行”

Claude看不到msty管理工具

1. 检查你的 claude_desktop_config.json 具有正确的绝对路径
2. 确保 run_msty_server.sh 可执行(chmod +x)
3. 完全重新启动克劳德桌面（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密钥处理 -钥匙从未被记录或归还
• 网络安全 -所有对localhost的调用，可配置超时

______________________________________________________________________

贡献

欢迎投稿！拜托：

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 详细的贡献指南。

______________________________________________________________________

学分

• 原作者: 菠萝 -创建了原始的msty管理员mcp
• v5.0.0+分叉: DigitalKredit -Msty 2.4.0+兼容性，模块化架构

______________________________________________________________________

许可证

MIT许可证-请参阅 许可证 了解详情。

______________________________________________________________________

致谢

• Msty工作室 -该MCP管理的优秀本地AI应用程序
• Anthropic -对于Claude和MCP协议
• 模型上下文协议 -使这成为可能的基础