Skip to content

Project Roadmap

Jump to bottom
Justin P Barnett edited this page Apr 8, 2025 · 1 revision

Unity MCP - Project Roadmap

Welcome to the Unity MCP roadmap! This document outlines our high-level goals, priorities, and planned features for the project. It's intended to give users and contributors insight into where the project is heading, enabling seamless communication between the Unity Editor and LLM tools like Claude Desktop and Cursor via the Model Context Protocol (MCP).

Please Note: This roadmap is a living document and reflects our current plans and priorities. These are subject to change based on community feedback, unforeseen challenges, or shifts in project direction. Timelines are estimates and not guarantees. The dates on linked issues/PRs may reflect when they were opened, not necessarily the target completion date.

Want to contribute or discuss the roadmap? We'd love your input! Please see the How to Contribute or Provide Feedback section below.

Table of Contents

Overall Vision & Goals

Our primary goal for Unity MCP is to provide a robust, flexible, and easy-to-use bridge and MCP server enabling powerful interactions between the Unity Editor and other MCP clients.

Key objectives driving our development include:

  • Goal 1: Simplify Installation & Configuration: Make setup straightforward and reliable across different platforms and MCP clients. (High Priority)
  • Goal 2: Enhance Stability & Performance: Ensure reliable communication and efficient handling of commands, especially in large projects.
  • Goal 3: Expand Features & Integrations: Add more tools, support more Unity features (like HDRP), and integrate with more AI services/tools.
  • Goal 4: Improve User & Developer Experience: Enhance documentation, provide better feedback/error handling, and support community contributions like localization.
  • Goal 5: Increase Maintainability & Testability: Refine the architecture and add tests to ensure long-term health.

Current Focus / Next Release (v1.1 / v2.0?)

We are currently focused on a significant refactoring of the Python Server Installation Process. The target is to decouple the Python server from the Unity package, installing it as a standalone application managed by uv. This aims to resolve numerous configuration issues and simplify setup.

Target: Aiming for completion in mid-April 2025.

Key items being actively worked on or planned for this cycle:

  • 🏗️ Architecture: Design and implement the standalone Python server installation and management mechanism (likely leveraging uv). [#Owner's Priority]
  • 🏗️ Architecture: Update UnityMcpBridge (C#) to detect, connect to, and manage the external Python server, removing internal server startup logic. [#Owner's Priority]
  • 📄 Docs: Revise README.md and potentially add Wiki pages detailing the new installation and setup procedure. (Related: Review/update based on #78)
  • 🐛 Bug Fix: Resolve installation/path issues potentially caused by the current bundled approach (Related: #60, #21).
  • 🐛 Bug Fix: Address Windows-specific installation command issues (Related: #66).
  • 🐛 Bug Fix: Investigate and potentially fix connection issues like SocketExceptions after script compilation (Related: #54).
  • 🧪 Tests: Add basic tests for the new installation and connection mechanism.

Legend: ✨ Feature, 🐛 Bug Fix, 📈 Improvement, 📄 Docs, 🧪 Tests, 🧹 Tech Debt/Refactoring, 🏗️ Architecture

Short-Term Plans (Post-Installation Overhaul)

Following the installation refactor, our focus will shift to Stabilization, Configuration Improvements, and Integrating Community Contributions.

Planned items include (priorities may change):

  • ✨ Feature: Add UI/Mechanism to configure connection to Azure OpenAI (Related: #64).
  • ✨ Feature: Explore persisting the MCP window state (Related: #67).
  • 📈 Improvement: Address remaining configuration difficulties for Cursor and Claude Desktop (Related: #77, #76, #61, #57, #20).
  • 📈 Improvement: Investigate performance bottlenecks, especially in large scenes (Related: #73).
  • 📈 Improvement: Add UnityMCP.Editor.asmdef for better project structure/compilation times (Related: #52).
  • 📈 Improvement: Add Chinese language support (Related: #62).
  • 📈 Improvement: Refine class loading via reflection (Related: #56, #55).
  • 🐛 Bug Fix: Address non-critical Python server errors during import (Related: #29).
  • 📄 Docs: Improve documentation for getting started with Cursor (Related: #20).

Mid-Term Plans

These are items we aim to tackle further out. Details and priorities are less defined.

  • Theme: New Editor Interactions & Integrations
    • ✨ Feature: Implement function to revise existing code (#75).
    • ✨ Feature: Implement function to import models via path (#74).
    • ✨ Feature: Explore Runtime MCP Operation (#58).
    • ✨ Feature: Add HDRP support (#27).
    • ✨ Feature: Add Trae AI Integration (#65).
    • ✨ Feature: Add Windsurf/Rodin auto-integration (#28, #18).
  • Theme: Quality of Life & Workflow
    • ✨ Feature: Option to auto-approve tool calls (#31).
    • 📈 Improvement: Explore ways to reduce context sent to LLM (#30).
  • Theme: Distribution
    • ✨ Feature: Prepare and upload to Unity Asset Store (#6).

Long-Term Ideas & Future Directions

This section captures bigger ideas or major features that are further down the line (>6-9 months) or require significant research/design.

  • Overhaul the Editor Window UI for better usability.
  • Create more auto-configurations to support for additional MCP clients.
  • More sophisticated scene analysis and manipulation tools.
  • Comprehensive automated testing suite.

Maybe / Icebox / Backlog

These are ideas that have been suggested or considered but are not currently planned for active development. They might be revisited later.

  • Visual scripting integration (e.g., Bolt/PlayMaker).

Recently Completed

For details on past releases and completed work, please see:

How to Contribute or Provide Feedback

Your feedback and contributions are crucial! Here's how you can get involved:

  1. Discuss Ideas: Use GitHub Discussions or open an issue with the enhancement or discussion label to discuss roadmap items or propose new ideas.
  2. Request Features: For specific, well-defined feature requests, please open a new issue using the "Feature Request" template. Check existing issues first!
  3. Report Bugs: If you find a bug, please open a bug report. Provide clear steps to reproduce.
  4. Contribute Code/Docs: Check our README.md guide for details. Look for issues tagged help wanted or good first issue. Review open Pull Requests.
  5. Comment on Issues/PRs: Provide feedback directly on the issues and pull requests linked in the roadmap sections above.

Disclaimer

This roadmap provides a high-level overview of potential future direction for Unity MCP. It is not a commitment or guarantee. Priorities and timelines may change significantly based on various factors including (but not limited to) community feedback, resource availability, technical challenges, and strategic shifts. We will strive to keep this document updated but please refer to specific GitHub Issues and Milestones for the most granular, up-to-date status.

Clone this wiki locally