READMEmain

Gamepad MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to control games through gamepad, keyboard, and mouse inputs.

Overview

This server implements the Model Context Protocol to allow AI assistants (like Claude) to send gamepad, keyboard, and mouse events to games. It acts as a bridge between the AI assistant and a WebSocket server that handles the actual input simulation.

Prerequisites

Node.js 16.x or higher
npm or yarn
Claude Desktop (or another MCP-compatible client)
A WebSocket server running on port 13123 to handle the input events

Installation

Clone this repository:

git clone https://github.com/yourusername/gamepad-mcp-server.git
cd gamepad-mcp-server

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Configure Claude Desktop by adding the following to your config file:

{
  "servers": [
    {
      "name": "gamepad-server",
      "command": "node /absolute/path/to/gamepad-mcp-server/build/index.js"
    }
  ]
}

Make the server executable:
```
chmod +x build/index.js
```

Event Format

Events are sent as JSON objects with the following structure: