HWCA MCP Server

A Model Context Protocol (MCP) server for the Horizon Worlds editor. This server provides tools and resources for automating context-management tasks, enabling GitHub CoPilot to understand the context of the Horizon Worlds TypeScript APIs.

*Be sure to add the corresponding Instructions and Tool Sets (provided in the .github folder) & copy their contents to your corresponding .github folder in your project's root directory.

Features

Tools

• execute_command - Execute system commands with optional arguments and working directory

• read_file - Read the contents of files

• write_file - Write content to files with optional directory creation

• list_directory - List directory contents with optional hidden files

• get_system_info - Get comprehensive system information

• list_processes - List running processes with optional filtering

• kill_process - Terminate processes by ID with optional force flag

Resources

• hwca://system/info - Current system information and status

• hwca://system/processes - List of currently running processes

Related MCP server: MCP Unity Editor

Installation

1. Clone this repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage

With Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS/Linux:

{
  "mcpServers": {
    "hwca": {
      "command": "node",
      "args": ["/path/to/hwca-mcp/build/index.js"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "hwca": {
      "command": "node",
      "args": ["C:\\path\\to\\hwca-mcp\\build\\index.js"]
    }
  }
}

Standalone Usage

You can also run the server directly:

npm start

Development

1. Install dependencies:

   npm install

2. Build the project:

   npm run build

3. For development with auto-rebuild:

   npm run dev

Security Considerations

This MCP server provides powerful system access capabilities including:

• File system read/write operations

• System command execution

• Process management

Important Security Notes:

• Only use this server in trusted environments

• Be cautious when granting AI assistants access to system commands

• Review and understand any commands before execution

• Consider running in a sandboxed environment for production use

Platform Support

This server supports:

• Windows (PowerShell commands)

• macOS (Unix commands)

• Linux (Unix commands)

Commands are automatically adapted based on the detected platform.

Examples

Execute a Command

// List files in current directory
{
  "command": "ls",
  "args": ["-la"],
  "workingDirectory": "/home/user"
}

Read a File

{
  "filePath": "/path/to/file.txt"
}

Write a File

{
  "filePath": "/path/to/new/file.txt",
  "content": "Hello, World!",
  "createDirectories": true
}

List Processes

{
  "filterBy": "node"  // Optional filter
}

License

MIT License

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

Support

For issues and questions, please open an issue on GitHub.