msty-admin-mcp 6.1.2__py3-none-any.whl

msty_admin_mcp-6.1.2.dist-info/METADATA

@@ -0,0 +1,361 @@
+Metadata-Version: 2.5
+Name: msty-admin-mcp
+Version: 6.1.2
+Summary: Comprehensive MCP server for administering Msty Studio Desktop 2.9+ with 56 tools, Studio entity inventory, insights analytics, Nexus bridge, Bloom evaluation, and a Cursor-agent handoff for local models
+Author-email: M-Pineapple 🍍 <128090761+M-Pineapple@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: mcp<2,>=1.0.0
+Requires-Dist: psutil>=5.9.0
+Provides-Extra: http
+Requires-Dist: starlette>=0.30.0; extra == 'http'
+Requires-Dist: uvicorn>=0.20.0; extra == 'http'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'test'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="assets/logo.svg" alt="Msty Admin MCP logo" width="240"/>
+
+# Msty Admin MCP — v6.1.2
+
+[![Licence: MIT](https://img.shields.io/github/license/M-Pineapple/msty-admin-mcp)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?logo=python&logoColor=white)](https://www.python.org)
+[![Stars](https://img.shields.io/github/stars/M-Pineapple/msty-admin-mcp)](https://github.com/M-Pineapple/msty-admin-mcp/stargazers)
+
+</div>
+
+<img src="assets/demo.gif" alt="msty-admin-mcp answering initialize and listing its tools" width="720"/>
+
+Comprehensive MCP server for administering **Msty Studio Desktop 2.9+** with **56 tools** across 9 phases: real Studio path/DB detection, entity inventory (Context Studio, Knowledge Stacks, Agent Mode, Turnstiles, …), insights analytics, Nexus bridge, Bloom evaluation, multi-backend local inference, and a handoff from a local model to the Cursor agent on this Mac.
+
+**Requirements**: Python 3.10+, MCP SDK v1.0.0+, psutil 5.9.0+
+
+**Latest**: v6.1.1 (2026-10-13) — stored API keys are now better protected in `read_msty_database`. Please update.
+
+> **New to Bloom?** Jump to the [Bloom Behavioral Evaluation](#bloom-behavioral-evaluation) section or read the [full Bloom guide](docs/BLOOM_GUIDE.md).
+
+---
+
+## Installation
+
+### Quick Start
+Needs Python 3.10 or newer.
+```bash
+pip install msty-admin-mcp
+msty-admin-mcp  # Runs on stdio (default MCP transport)
+```
+
+If `pip install msty-admin-mcp` cannot find the package, install the release straight from GitHub:
+```bash
+pip install "msty-admin-mcp @ git+https://github.com/M-Pineapple/msty-admin-mcp@v6.1.2"
+```
+
+### With HTTP Transport
+```bash
+pip install "msty-admin-mcp[http]"
+msty-admin-mcp --transport streamable-http  # Runs on http://localhost:8000
+```
+
+### From Source
+```bash
+git clone https://github.com/M-Pineapple/msty-admin-mcp
+cd msty-admin-mcp
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[test]"
+pytest tests/ -v
+```
+
+This server targets the 1.x MCP Python SDK (`mcp>=1.0.0,<2`).
+
+---
+
+## Usage
+
+Once the server is registered with Msty Studio (or another MCP host), ask in natural language. The host maps your words onto the tools.
+
+### Health and install
+
+- "Detect my Msty installation and show the version."
+- "Analyse Msty health."
+- "What is the MCP server status?"
+
+### Studio inventory
+
+- "List my personas and knowledge stacks."
+- "Show all workspaces."
+- "List the tools in my Toolbox."
+- "Export a workflow pack for my current workspace."
+
+### Local models and services
+
+- "Which local models are available?"
+- "Recommend a model for summarising long documents."
+- "What is the Nexus status and which models does it expose?"
+
+### Analytics and Bloom
+
+- "Show model performance metrics from Studio insights."
+- "Analyse my conversation patterns."
+- "Run a Bloom evaluation for sycophancy on this model."
+
+### Frontier handoff
+
+For a local-model chat, use the one-tool Frontier server (see [Hybrid local model and Cursor agent](#hybrid-local-model-and-cursor-agent)):
+
+- "Ask the Cursor agent on this Mac why this SwiftUI view is not updating."
+
+---
+
+## Configuration
+
+Environment variables (all optional, sensible defaults):
+
+```bash
+# Msty installation host
+MSTY_HOST=127.0.0.1
+
+# Service backend ports (also read from Studio Gifnoc.nosj when present)
+MSTY_AI_PORT=11964           # Local AI (Ollama)
+MSTY_MLX_PORT=11973          # MLX service
+MSTY_LLAMACPP_PORT=11454     # LLaMA.cpp service
+MSTY_VIBE_PORT=8317          # Vibe CLI Proxy
+MSTY_NEXUS_PORT=11434        # Msty Nexus OpenAI-compatible gateway
+
+# Service timeout
+MSTY_TIMEOUT=10              # Seconds
+
+# Bloom integration (required for Phase 6 tools)
+ANTHROPIC_API_KEY=sk-...     # Required for Bloom judge model
+```
+
+---
+
+## Architecture
+
+### Studio 2.9+ data layout
+
+Msty Studio no longer uses a top-level `msty.db`. The workspace SQLite lives under the Chromium File System API path, for example:
+
+```
+~/Library/Application Support/MstyStudio/
+├── Gifnoc.nosj                          # service config (ports / model paths)
+├── models/  models-mlx/
+└── File System/000/t/00/00000000        # Drizzle SQLite workspace DB
+```
+
+The MCP auto-detects `/Applications/MstyStudio.app`, reads the bundle version, resolves the SQLite blob, and opens it **read-only**.
+
+### Service discovery
+
+```
+Msty Studio Desktop
+├── Local AI (Ollama) → port 11964
+├── MLX → port 11973
+├── LLaMA.cpp → port 11454
+├── Vibe CLI Proxy → port 8317
+└── Msty Nexus (optional) → port 11434
+
+         ↓
+
+MCP Server (stdio / HTTP)
+├── Phase 1: Foundational (6)
+├── Phase 2: Configuration (4)
+├── Phase 3: Service Integration (11)
+├── Phase 4: Intelligence (5)
+├── Phase 5: Calibration (4)
+├── Phase 6: Bloom Evaluation (6)
+├── Phase 7: Studio Inventory (15)
+├── Phase 8: Nexus Bridge (4)
+└── Phase 9: Frontier handoff (1)
+```
+
+---
+
+## Hybrid local model and Cursor agent
+
+A local model does the ordinary work. When a question is past it, that model calls `ask_frontier`. The tool runs the Cursor agent on this machine and returns the answer in the same Msty chat. A follow-up resumes that Cursor chat.
+
+Use a **separate one-tool server** for the local-model chat. The full admin server has 56 tools. A small model will call those other tools (GitHub, search, schema, and so on) instead of waiting for the answer.
+
+### Fresh install
+
+1. Install this package and the Cursor agent CLI (`cursor-agent`). It must be on the PATH seen by Msty, or at `~/.local/bin/cursor-agent`. Login and API keys: [Cursor CLI authentication](https://cursor.com/docs/cli/reference/authentication).
+2. Create a **user** API key in Cursor Dashboard → API Keys. An admin key does not work. Do not commit the key and do not put it in this repo.
+3. In Msty, add a toolbox server named Frontier. From a source checkout:
+
+```json
+{
+  "command": "/absolute/path/to/venv/bin/python",
+  "args": ["-m", "src.frontier_main"],
+  "env": {
+    "PYTHONPATH": "/absolute/path/to/msty-admin-mcp",
+    "CURSOR_API_KEY": "your-user-api-key"
+  }
+}
+```
+
+After `pip install`, the console script `msty-frontier` is the same one-tool server. You can set `command` to that script and omit `PYTHONPATH`.
+
+4. Create a toolset that contains **only** this Frontier server. Do not put GitHub, Brave, Trello, or the full admin server in that toolset.
+5. On the local-model chat, select that toolset in the composer (the active-toolset control). The toolset stored on the chat is not what is sent if the composer still has another toolset selected.
+6. Quit Msty and open it again after any toolbox or environment change.
+7. Ask a question the local model cannot already answer. Success is one `ask_frontier` card, then the Cursor reply under it. A normal paragraph with no card means the model answered by itself and Cursor was not asked.
+
+### Optional project folder
+
+By default the Cursor agent reads an empty folder under `~/.msty-admin/frontier-workspace`. It cannot see your repositories. To let it read one project, set:
+
+```json
+"MSTY_FRONTIER_WORKSPACE": "/absolute/path/to/that/project"
+```
+
+Ask mode does not send mail, move or delete files, or use trading tools. It can read that folder.
+
+### Update from v6.0.0
+
+The admin server is unchanged for Studio inventory and the other 55 tools. Add the Frontier server and the one-server toolset as above. Do not point the local-model chat at the full `msty-admin-mcp` command.
+
+### Caveats
+
+- The local model must emit a real tool call. Some small models never do, and then no amount of "please call the tool" in the user message will reach Cursor. A model that can call tools will. It may rewrite your question into a search command. That is still a successful handoff if the card is `ask_frontier` and the text under it came from Cursor.
+- `cursor-agent status` can say "not logged in" while ask mode still works with `CURSOR_API_KEY`. The frontier process passes that variable as `--api-key`. A browser `cursor-agent login` in your terminal is not always visible to the process Msty starts.
+- Several `ask_frontier` calls in one reply share the first Cursor answer. They do not each start a new chat.
+- The last Cursor chat id is stored in `~/.msty-admin/frontier-session.json` (mode `0600`). Delete that file to start a fresh Cursor chat.
+- `identify_handoff_triggers` only scores past speed and latency. It does not send the question.
+
+---
+
+## Tools Summary (56 Total)
+
+### Phase 1: Foundational (6)
+- `detect_msty_installation` — app, version, DB path, ports
+- `read_msty_database` — `stats` / `tables` / read-only SQL
+- `list_configured_tools` — Toolbox MCP tools
+- `get_model_providers` — services + Studio providers (keys redacted)
+- `analyse_msty_health` — install + DB + services
+- `get_server_status` — MCP status
+
+### Phase 2: Configuration (4)
+- `export_tool_config` — export a tool by name/id
+- `sync_claude_preferences` — Claude ↔ Msty delta report
+- `generate_persona` — persona JSON for Persona Studio
+- `import_tool_config` — validate import (live DB writes refused by default)
+
+### Phase 3: Service Integration (11)
+- `get_service_status`, `list_available_models`, `query_local_ai_service`
+- `chat_with_local_model`, `recommend_model`
+- `list_mlx_models`, `chat_with_mlx_model`
+- `list_llamacpp_models`, `chat_with_llamacpp_model`
+- `get_vibe_proxy_status`, `query_vibe_proxy`
+
+### Phase 4: Intelligence (5)
+- `get_model_performance_metrics` — from Studio `insightsLanguageModelUsage`
+- `analyse_conversation_patterns`
+- `compare_model_responses`
+- `optimise_knowledge_stacks` — live Next Gen / draft / compose status
+- `suggest_persona_improvements`
+
+### Phase 5: Calibration (4)
+- `run_calibration_test`, `evaluate_response_quality`
+- `identify_handoff_triggers`, `get_calibration_history`
+
+### Phase 6: Bloom Evaluation (6)
+- `bloom_evaluate_model`, `bloom_check_handoff`, `bloom_get_history`
+- `bloom_list_behaviors`, `bloom_get_thresholds`, `bloom_validate_model`
+
+### Phase 7: Studio 2.9 Inventory (15)
+- `list_studio_catalogue`, `list_workspaces`, `list_personas`
+- `list_shadow_personas`, `list_crews`, `list_knowledge_stacks`
+- `list_turnstiles`, `list_skills`, `list_live_contexts`, `list_prompts`
+- `list_context_studio`, `list_agent_plans`
+- `get_studio_entity`, `get_schema_migrations`, `export_workflow_pack`
+
+### Phase 8: Nexus Bridge (4)
+- `detect_nexus`, `list_nexus_models`, `query_nexus`, `get_insights_usage`
+
+### Phase 9: Frontier handoff (1)
+- `ask_frontier` — hand one question to the Cursor agent on this machine and return the answer in the Msty chat. Use the one-tool server (`msty-frontier` or `python -m src.frontier_main`) for a local-model chat. See [Hybrid local model and Cursor agent](#hybrid-local-model-and-cursor-agent).
+
+---
+
+## Bloom Behavioral Evaluation
+
+Phase 6 introduces behavioral evaluation powered by [Anthropic's Bloom framework](https://www.anthropic.com/research/bloom). Rather than testing what a model knows, Bloom tests how it behaves — detecting failure modes like sycophancy, hallucination, and overconfidence that standard benchmarks miss.
+
+See the **[Bloom Knowledge Base Guide](docs/BLOOM_GUIDE.md)**.
+
+---
+
+## Testing
+
+```bash
+pytest tests/ -v
+```
+
+v6 ships unit tests for path resolution, read-only SQL guards, redaction, inventory/analytics, and MCP tool JSON contracts. Live smoke on Studio 2.9.2 was verified during release.
+
+---
+
+## FAQ
+
+### Q: How does a local model ask Cursor?
+**A**: Run the one-tool server, put only that server in the chat's toolset, and set `CURSOR_API_KEY` on that server. Steps and caveats are in [Hybrid local model and Cursor agent](#hybrid-local-model-and-cursor-agent). The key stays in Msty's toolbox environment. It does not belong in this repository.
+
+### Q: Why did detection fail on older MCP versions?
+**A**: v5 looked for `~/Library/Application Support/Msty/msty.db`. Studio 2.x stores data under `MstyStudio` and the Chromium File System SQLite path. v6 fixes this.
+
+### Q: Can I use this with Msty &lt; 2.4.0?
+**A**: No. v6 targets Studio 2.9+ (works on 2.4+ layouts when the File System DB is present). Use v4.x for older process-based detection.
+
+### Q: Does this write to the Studio database?
+**A**: Inventory and analytics are read-only. `import_tool_config` refuses live writes by default because Studio may hold locks on the File System DB. Prefer Toolbox JSON import for writes.
+
+### Q: What's the Nexus integration?
+**A**: [Msty Nexus](https://msty.ai/nexus/) is the local runtime/gateway. Phase 8 detects it and lists models via its OpenAI-compatible endpoint (`MSTY_NEXUS_PORT`).
+
+---
+
+## License
+
+MIT License — See LICENSE file
+
+## Contributing
+
+Contributions welcome! Please open issues or PRs on GitHub.
+
+## More MCP servers by M-Pineapple
+
+Other MCP servers in this portfolio:
+
+- [Claude Project Coordinator](https://github.com/M-Pineapple/Claude-Project-Coordinator). Track Xcode projects, status, tech stack and health.
+- [CryptoAnalysisMCP](https://github.com/M-Pineapple/CryptoAnalysisMCP). Cryptocurrency technical analysis for Claude Desktop.
+- [Warp Command Runner](https://github.com/M-Pineapple/warp-command-runner). Give any chat AI a real terminal.
+- [Member Berries](https://github.com/M-Pineapple/member-berries-apple-mcp). Apple Calendar, Notes and Reminders with personality.
+- [SeaShell](https://github.com/M-Pineapple/seashell). Talk to Claude from any terminal block.
+- [TextEdit MCP](https://github.com/M-Pineapple/TextEdit-MCP). Formatted RTF documents via macOS TextEdit.
+- [HubSpot Auditor](https://github.com/M-Pineapple/hubspot-auditor). Read-only HubSpot portal audit.
+
+## 💖 Support This Project
+
+If this project has helped enhance your development workflow or saved you time, please support :
+
+<a href="https://www.buymeacoffee.com/mpineapple" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
+
+Your support helps me:
+
+* Maintain and improve this project with new features
+* Keep the project open-source and free for everyone
+* Dedicate more time to addressing user requests and bug fixes
+* Explore new terminal integrations and command intelligence
+
+Thank you for considering supporting my work! 🙏
+
+## Support
+
+For issues, questions, or feature requests, visit: https://github.com/M-Pineapple/msty-admin-mcp
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/m-pineapple-msty-admin-mcp-badge.png)](https://mseep.ai/app/m-pineapple-msty-admin-mcp)

msty_admin_mcp-6.1.2.dist-info/RECORD

@@ -0,0 +1,29 @@
+src/__init__.py,sha256=utEEyAotY8ZTpFxaM5hCKLLmIhROxRgeISPklF6tUZ8,563
+src/analytics.py,sha256=Rny0FjbPbPMTziJ6amlKwCgggmMKJeywCH-4FJoiCEA,9282
+src/db.py,sha256=xS3qQKlt-jY3F7YF2DWwJUQN_UR2aV-4s3RcBZZ8_e8,12181
+src/frontier.py,sha256=I53m6SjGflCcjA7cIL0TXzXO0zH-Nen5m8N76eP63SY,10419
+src/frontier_main.py,sha256=b8u1tznMTncEyPfPrIA_WzXiT6xuec0y6TYsGiQGedc,673
+src/inventory.py,sha256=Zso1xo04J3POBW8YGrFq3xaFOyBPcoRIhVRPHjeWGjY,6783
+src/nexus.py,sha256=tnheTuglQT9pcG6DJykgpVzDi-oAcbGdmVce00AOjv4,1927
+src/paths.py,sha256=p7Q_ThiDghvnoW6NMvsWZbI4H-XZS33DF-CAIPQH8YE,11716
+src/phase4_5_tools.py,sha256=OOKNuCXimU3qZ9j3un28VSFGrftaaEz1dXb1Pqu3KmQ,11513
+src/server.py,sha256=9HxWy2DRYcQtuMWGEXrchK6dMfMJxqgnoA7_mOmJtbU,33748
+src/services.py,sha256=phq7AAJYCQFyUB0UHV282mDXabII0Gp-v9fTqfMa3q8,3627
+src/automation/__init__.py,sha256=fH12fTi0Sske_62MB01c9W850o9uhEKof4Jw8dRtAxk,87
+src/bloom/__init__.py,sha256=fNf89cBG1tRxQPC_jP6xaempDJYl8RhVfiygY9EdDJk,482
+src/bloom/cv_behaviors.py,sha256=3XlX9Qzg8lkYZo1qhXi7RQf_EBqgDBKNeX22l-YHKl0,3467
+src/bloom/evaluator.py,sha256=vRiH-shw2eyVqSL3rDOLqW9QV-H8mzCb6Y9naP2-_sA,10566
+src/bloom/example_behaviors.py,sha256=c91W5HzoaWIKdhdzBpHOxx4c5HoN1f2TYB1xE3P3OvM,136
+src/bloom/mcp_tools.py,sha256=-NOnheAIbtPGrx-M0IkSxFzIPPRIvdMmqxiLA3as_5Y,7952
+src/bloom/ollama_adapter.py,sha256=hN-3xYe7f8r3x45iQspv5Fx3gE8v3St9xuA8D9zCeHw,6746
+src/calibration/__init__.py,sha256=atKnFTBaFpB4AsT2XW7F0Qof_cKPY0nCHfR_xlHCuD0,217
+src/config/__init__.py,sha256=zrAw9mEHTf1veGXQTCL7prFv1V70-TFj2vq8Gz7SuIY,80
+src/database/__init__.py,sha256=p0uS9vkvknxnbMvOQD0RbIgNy7SQvSr3_m6wgkFOYKs,118
+src/hardware/__init__.py,sha256=XpJuI6gIPP8pHZxH35h9284PxUXZQS5jf4MF8j9By1o,90
+src/intelligence/__init__.py,sha256=_x7kUgekt0Y4IB9hAk_Esiw9JoZpFbE5JGukx5w8cWw,259
+src/utils/__init__.py,sha256=fWhNCmh2pgLoF1Nvcnd00C4nbfMEj1ud7UgSem8HPzI,92
+msty_admin_mcp-6.1.2.dist-info/METADATA,sha256=1-UkrhA_K4GQEVmq6r3oyuIarwZdgdbr63NPI0ajpmM,15429
+msty_admin_mcp-6.1.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+msty_admin_mcp-6.1.2.dist-info/entry_points.txt,sha256=-01eko4y8B0DCOi1x9v_PeRmsTVsupD8Of_cJiAu-Bg,90
+msty_admin_mcp-6.1.2.dist-info/licenses/LICENSE,sha256=Azq0KQLAMkeTFR8WYXsKQBjTNOeadkrWjqu8XNSuqRQ,1079
+msty_admin_mcp-6.1.2.dist-info/RECORD,,

msty_admin_mcp-6.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

msty_admin_mcp-6.1.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+msty-admin-mcp = src.server:main
+msty-frontier = src.frontier_main:main

msty_admin_mcp-6.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025–2026 M-Pineapple 🍍
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

src/__init__.py

@@ -0,0 +1,21 @@
+"""
+Msty Admin MCP Server
+
+AI-administered Msty Studio Desktop management system with database insights,
+configuration management, local model orchestration, and tiered AI workflows.
+
+Phase 1: Foundational Tools (Read-Only)
+Phase 2: Configuration Management
+Phase 3: Automation Bridge (Sidecar Integration)
+Phase 4: Intelligence Layer (Analytics)
+Phase 5: Tiered AI Workflow (Calibration)
+
+Created by M-Pineapple 🍍
+"""
+
+__version__ = "6.1.2"
+__author__ = "M-Pineapple 🍍"
+
+from .server import mcp, main
+
+__all__ = ["mcp", "main", "__version__", "__author__"]