# Peggle AI MCP Server

This MCP server allows an AI to play Peggle by capturing the screen and controlling the mouse.

## Tools

- `capture_screen`: Captures the primary monitor and returns the image as base64.
- `click_at(x, y)`: Moves the mouse to (x, y) and performs a left click.

## How to use with LM Studio

1. **Build the server**:
   ```bash
   npm install && npm run build
   ```
2. **Configure LM Studio**:
   - Open LM Studio and go to the **MCP** tab.
   - Click **Add Server**.
   - Set the command to `node` (ensure node is in your PATH).
   - Set the arguments to the absolute path of the built `index.js`, for example:
     `C:\Users\{youruser}\peggle-ai-mcp\dist\index.js`
   - If needed, you can use the mcp.json already included here and paste in the json contents to your mcp.json for it to work
   - Alternatively, use `npx`:
     - Command: `npx`
     - Arguments: `-y C:\Users\maxwe\Desktop\peggle-ai-mcp`
    

3. **Start Playing**:
   - Open Peggle (make sure it's on your primary monitor).
   - In LM Studio, select a model that supports vision and tools (e.g., Ministral 3B, or any other vision-capable model).
   - Ask the AI: "Take a screenshot of Peggle, analyze where the best shot is, and click there."

## Implementation Details

- **Screen Capture**: Uses `screenshot-desktop`.
- **Mouse Control**: Uses PowerShell commands via `child_process` for cross-platform compatibility on Windows without needing native build tools.
- **Protocol**: Model Context Protocol (MCP).

## Note on Windows 11

Ensure that PowerShell execution policy allows running the commands if you encounter issues. The server uses standard PowerShell calls that should work in most default configurations