Metadata-Version: 2.4
Name: coplay-mcp-server
Version: 1.5.1
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: fastmcp>=2.0.0
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

- **Schema-Based Tool Registration**: Dynamically registers tools from JSON schema files, ensuring compatibility with Backend's AssistantMode.NORMAL
- **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
- **Parameter Validation**: Automatic parameter validation and type conversion based on tool schemas
- **Version Compatibility**: Tools are locked to specific schema versions, ensuring compatibility with Unity plugin versions

## Usage

### As an MCP server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "coplay-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uvx",
      "args": [
        "coplay-mcp-server@latest"
      ]
    }
  }
}
```


