msty-admin

Msty Admin MCP is a Python-based server that coordinates Msty Studio Desktop tooling via the Model Context Protocol. It provides 36 tools spread across six phases, including foundational checks, configuration synchronization, multi-backend model orchestration, and Bloom-based behavioral evaluation for safety and reliability. The server can connect to multiple local backends (Ollama, MLX, LLaMA.cpp, and Vibe Proxy) through port-based service discovery, automatically wiring available tools to the MCP transport (stdio or HTTP). This makes it suitable for automating admin tasks, inspecting internal state, and conducting cross-backend prompts and evaluations with consistent interfaces. The included Bloom evaluation features allow you to test for behaviors like sycophancy, hallucination, and overconfidence, and then decide whether to hand off to Claude for specific task categories.

Prerequisites:

• Python 3.10+
• pip (comes with Python)
• Optional: git if you want to clone the repository

Install from PyPI (quick start):

pip install msty-admin-mcp

Run with default MCP transport (stdio):

msty-admin-mcp

Run with HTTP transport (streamable-http) support:

pip install msty-admin-mcp[http]
msty-admin-mcp --transport streamable-http

From source (clone-and-install in editable mode):

git clone https://github.com/M-Pineapple/msty-admin-mcp
cd msty-admin-mcp
pip install -e .

Configure environment (optional, shown below) and run as a Python module:

# Example: run via module (uses default stdio transport)
python -m msty_admin_mcp

Environment variables:

• MSTY_HOST, MSTY_AI_PORT, MSTY_MLX_PORT, MSTY_LLAMACPP_PORT, MSTY_VIBE_PORT control connection to local backends.
• MSTY_TIMEOUT sets the per-tool service timeout in seconds.
• ANTHROPIC_API_KEY is required for Bloom behavioral evaluation (Phase 6); ensure you have an active Anthropic Bloom key.

Common issues:

• Service discovery may fail if the local backends are not running or ports differ from defaults.
• Bloom features require a valid ANTHROPIC_API_KEY; without it, Bloom evaluation tools will not execute.
• If running HTTP transport, ensure you have the http extra installed and that port 8000 is not in use by another service.

Configuration tips:

• Keep MSTY_HOST reachable from the MCP server to allow instrumented health checks and data collection.
• The metrics SQLite database is stored by default at ~/.msty-admin/msty_admin_metrics.db and is auto-initialized on first use.