💎 Orbis Prism MCP

Leer en español

"Deconstruct the engine, illuminate the API."

<img width="938" height="407" alt="Orbis Prism Banner" src="docs/assets/banner.png" />

Orbis Prism is a powerful SDK analysis tool for Hytale developers. It automatically detects your game installation, decompiles the server logic, and provides an intelligent AI-ready interface via the Model Context Protocol (MCP).

[!IMPORTANT] Orbis Prism requires an official Hytale installation. This tool does not distribute any game source code or binaries.

---

🚀 Quick Start

1. Install Install directly from PyPI:

   pip install orbis_prism_mcp
   

   (Or for local development: pip install -e .)

2. Initialize Workspace This command detects your Hytale installation, decompiles the server, and indexes the API and assets.

   prism ctx init --assets
   

3. Start MCP Server

   prism mcp
   

---

⚙️ Requirements

• Official Hytale Installation (Launcher and game files).
• Python 3.11+
• Java 17-25 (Required for Hytale server compatibility and JADX/Vineflower).

---

🏗️ Default Storage

By default, Orbis Prism uses a global storage directory at ~/.prism for configuration and databases.

If you want to use a specific directory as a workspace (local project), initialize it using prism ctx init within that folder or use the -w flag.

---

🏛️ Project Features

• Global CLI: Run prism from any directory.
• Global Options: Use --version or -v to check the tool version.
• Decompiler Choice: Switch between JADX (default) and Vineflower engines.
• Deep Indexing: Fast API search with SQLite FTS5.
• Asset Exploration: Search and inspect Hytale assets (JSON, models, textures) directly from Assets.zip.
• AI-Ready: Native MCP server for integration with Cursor, Claude, and more.

---

📚 Documentation

Detailed documentation is available for different areas of the project:

• CLI Reference — Full command list and advanced usage.
• MCP Server Guide — How to connect Orbis Prism to Cursor, Claude, or other AI agents.
• Agent Context & Architecture — Technical details for contributors and AI development.
• The Developer's Prism — Our philosophy and purpose.
• Contributing — Help us improve the tool.

---

🌍 Language Support

The CLI supports both English and Spanish.

prism lang set en  # Switch to English
prism lang set es  # Cambiar a Español

---

⚖️ License

This project is licensed under the MIT License. See the LICENSE file for details.