coplay-mcp-server 1.2.0__tar.gz

coplay_mcp_server-1.2.0/.gitignore

@@ -0,0 +1,175 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore.  For a PyCharm
+#  project, it is recommended to ignore the entire .idea directory.
+.idea/
+
+# VS Code
+.vscode/
+
+# Logs
+logs/
+*.log
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

coplay_mcp_server-1.2.0/.python-version

@@ -0,0 +1 @@
+3.11

coplay_mcp_server-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Coplay Dev
+
+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.

coplay_mcp_server-1.2.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: coplay-mcp-server
+Version: 1.2.0
+Summary: A Model Context Protocol (MCP) server for Coplay, providing Unity integration capabilities
+Project-URL: Homepage, https://coplay.dev/
+Project-URL: Repository, https://github.com/CoplayDev/coplay-unity-plugin
+Project-URL: Documentation, https://docs.coplay.dev/
+Project-URL: Issues, https://github.com/CoplayDev/coplay-unity-plugin/issues
+Author-email: Coplay Dev <dev@coplay.com>
+Maintainer-email: Coplay Dev <dev@coplay.com>
+License: MIT
+License-File: LICENSE
+Keywords: coplay,mcp,model-context-protocol,unity,unity-editor
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: anyio>=4.10.0
+Requires-Dist: mcp[cli]>=1.12.4
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: watchdog>=6.0.0
+Description-Content-Type: text/markdown
+
+# Coplay MCP Server
+
+A Model Context Protocol (MCP) server for Coplay, providing Unity Editor integration capabilities through MCP tools.
+
+## Features
+
+- **Unity Project Discovery**: Automatically discover running Unity Editor instances and their project roots
+- **Unity Editor State**: Retrieve current Unity Editor state and scene hierarchy information
+- **Script Execution**: Execute arbitrary C# scripts within the Unity Editor
+- **Log Management**: Access and filter Unity console logs
+- **GameObject Hierarchy**: List and filter GameObjects in the scene hierarchy
+- **Task Creation**: Create new Coplay tasks directly from MCP clients
+
+## Usage
+
+### As an MCP server
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "coplay-testpypi": {
+      "autoApprove": [],
+      "disabled": false,
+      "timeout": 60,
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--index-url",
+        "https://test.pypi.org/simple/",
+        "--extra-index-url",
+        "https://pypi.org/simple/",
+        "coplay-mcp-server@latest"
+      ]
+    }
+  }
+}
+```
+
+## Available Tools
+
+- `set_unity_project_root` - Set the Unity project root path
+- `list_unity_project_roots` - Discover all running Unity Editor instances
+- `execute_script` - Execute C# scripts in Unity Editor
+- `get_unity_logs` - Retrieve Unity console logs with filtering
+- `get_unity_editor_state` - Get current Unity Editor state
+- `list_game_objects_in_hierarchy` - List GameObjects with filtering options
+- `create_coplay_task` - Create new Coplay tasks
+
+## Development
+
+To launch the server in development mode:
+
+```bash
+uv run mcp dev coplay_mcp_server/server.py
+```
+
+### Prerequisites
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) package manager
+- Unity Editor with Coplay plugin installed
+
+### Project Structure
+
+- `coplay_mcp_server/server.py` - Main MCP server implementation
+- `coplay_mcp_server/unity_client.py` - Unity RPC client for communication
+- `coplay_mcp_server/process_discovery.py` - Process discovery utilities
+- `pyproject.toml` - Project configuration and dependencies
+
+## License
+
+MIT License - see LICENSE file for details.

coplay_mcp_server-1.2.0/README.md

@@ -0,0 +1,74 @@
+# Coplay MCP Server
+
+A Model Context Protocol (MCP) server for Coplay, providing Unity Editor integration capabilities through MCP tools.
+
+## Features
+
+- **Unity Project Discovery**: Automatically discover running Unity Editor instances and their project roots
+- **Unity Editor State**: Retrieve current Unity Editor state and scene hierarchy information
+- **Script Execution**: Execute arbitrary C# scripts within the Unity Editor
+- **Log Management**: Access and filter Unity console logs
+- **GameObject Hierarchy**: List and filter GameObjects in the scene hierarchy
+- **Task Creation**: Create new Coplay tasks directly from MCP clients
+
+## Usage
+
+### As an MCP server
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "coplay-testpypi": {
+      "autoApprove": [],
+      "disabled": false,
+      "timeout": 60,
+      "type": "stdio",
+      "command": "uvx",
+      "args": [
+        "--index-url",
+        "https://test.pypi.org/simple/",
+        "--extra-index-url",
+        "https://pypi.org/simple/",
+        "coplay-mcp-server@latest"
+      ]
+    }
+  }
+}
+```
+
+## Available Tools
+
+- `set_unity_project_root` - Set the Unity project root path
+- `list_unity_project_roots` - Discover all running Unity Editor instances
+- `execute_script` - Execute C# scripts in Unity Editor
+- `get_unity_logs` - Retrieve Unity console logs with filtering
+- `get_unity_editor_state` - Get current Unity Editor state
+- `list_game_objects_in_hierarchy` - List GameObjects with filtering options
+- `create_coplay_task` - Create new Coplay tasks
+
+## Development
+
+To launch the server in development mode:
+
+```bash
+uv run mcp dev coplay_mcp_server/server.py
+```
+
+### Prerequisites
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) package manager
+- Unity Editor with Coplay plugin installed
+
+### Project Structure
+
+- `coplay_mcp_server/server.py` - Main MCP server implementation
+- `coplay_mcp_server/unity_client.py` - Unity RPC client for communication
+- `coplay_mcp_server/process_discovery.py` - Process discovery utilities
+- `pyproject.toml` - Project configuration and dependencies
+
+## License
+
+MIT License - see LICENSE file for details.

coplay_mcp_server-1.2.0/coplay_mcp_server/__init__.py

@@ -0,0 +1,3 @@
+"""Coplay MCP Server - Unity Editor integration via MCP protocol."""
+
+__version__ = "1.2.0"

coplay_mcp_server-1.2.0/coplay_mcp_server/process_discovery.py

@@ -0,0 +1,169 @@
+"""Unity process discovery utilities."""
+
+import logging
+import platform
+from pathlib import Path
+from typing import List, Optional
+
+import psutil
+
+logger = logging.getLogger(__name__)
+
+
+def find_unity_processes() -> List[psutil.Process]:
+    """Find all running Unity Editor processes."""
+    unity_processes = []
+    
+    try:
+        for proc in psutil.process_iter(['pid', 'name', 'cmdline']):
+            try:
+                proc_info = proc.info
+                if not proc_info['name']:
+                    continue
+                    
+                name = proc_info['name'].lower()
+                
+                # Check for Unity process names across platforms
+                if any(unity_name in name for unity_name in [
+                    'unity', 'unity.exe', 'unity editor', 'unity hub'
+                ]):
+                    # Skip Unity Hub, we only want Editor instances
+                    if 'hub' not in name:
+                        unity_processes.append(proc)
+                        
+            except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+                continue
+                
+    except Exception as e:
+        logger.error(f"Error finding Unity processes: {e}")
+        
+    return unity_processes
+
+
+def extract_project_path_from_cmdline(cmdline: List[str]) -> Optional[str]:
+    """Extract Unity project path from command line arguments."""
+    if not cmdline:
+        return None
+        
+    try:
+        # Look for -projectPath argument
+        for i, arg in enumerate(cmdline):
+            if arg.lower() == "-projectpath" and i + 1 < len(cmdline):
+                project_path = cmdline[i + 1]
+                # Remove quotes if present
+                project_path = project_path.strip('"\'')
+                return project_path
+                
+    except Exception as e:
+        logger.debug(f"Error extracting project path from cmdline: {e}")
+        
+    return None
+
+
+def verify_unity_project(project_path: str) -> bool:
+    """Verify that a path is a valid Unity project."""
+    try:
+        project_dir = Path(project_path)
+        if not project_dir.exists() or not project_dir.is_dir():
+            return False
+            
+        # Check for Assets folder (required for Unity projects)
+        assets_dir = project_dir / "Assets"
+        if not assets_dir.exists() or not assets_dir.is_dir():
+            return False
+            
+        return True
+        
+    except Exception as e:
+        logger.debug(f"Error verifying Unity project at {project_path}: {e}")
+        return False
+
+
+def _discover_from_temp_dirs() -> List[str]:
+    """Discover Unity projects from MCP request directories in temp locations."""
+    project_roots = []
+    
+    try:
+        # Common temp directory locations
+        temp_paths = []
+        
+        if platform.system() == "Windows":
+            import tempfile
+            temp_paths.append(Path(tempfile.gettempdir()))
+            # Also check AppData/Local
+            try:
+                from pathlib import Path
+                appdata_local = Path.home() / "AppData" / "Local"
+                if appdata_local.exists():
+                    temp_paths.append(appdata_local)
+            except Exception:
+                pass
+        else:
+            # Unix-like systems
+            temp_paths.extend([
+                Path("/tmp"),
+                Path.home() / ".cache",
+                Path("/var/tmp")
+            ])
+        
+        for temp_path in temp_paths:
+            if not temp_path.exists():
+                continue
+                
+            try:
+                # Look for Coplay MCP request directories
+                for path in temp_path.rglob("**/Temp/Coplay/MCPRequests"):
+                    if path.is_dir():
+                        # Try to infer project root from temp path structure
+                        temp_index = None
+                        parts = path.parts
+                        
+                        for i, part in enumerate(parts):
+                            if part.lower() == "temp":
+                                temp_index = i
+                                break
+                                
+                        if temp_index and temp_index > 0:
+                            project_path = str(Path(*parts[:temp_index]))
+                            if verify_unity_project(project_path):
+                                project_roots.append(project_path)
+                                
+            except Exception as e:
+                logger.debug(f"Error searching temp path {temp_path}: {e}")
+                
+    except Exception as e:
+        logger.debug(f"Error discovering from temp directories: {e}")
+        
+    return project_roots
+
+
+def discover_unity_project_roots() -> List[str]:
+    """Discover all Unity project roots from running processes."""
+    project_roots = []
+    
+    try:
+        unity_processes = find_unity_processes()
+        logger.info(f"Found {len(unity_processes)} Unity processes")
+        
+        for proc in unity_processes:
+            try:
+                cmdline = proc.cmdline()
+                project_path = extract_project_path_from_cmdline(cmdline)
+                
+                if project_path and verify_unity_project(project_path):
+                    if project_path not in project_roots:
+                        project_roots.append(project_path)
+                        logger.info(f"Found Unity project: {project_path}")
+                        
+            except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+                continue
+            except Exception as e:
+                logger.debug(f"Error processing Unity process {proc.pid}: {e}")
+                
+    except Exception as e:
+        logger.error(f"Error discovering Unity project roots: {e}")
+        
+    # Also check for MCP request directories in temp locations
+    project_roots.extend(_discover_from_temp_dirs())
+    
+    return list(set(project_roots))  # Remove duplicates