Aether

Claude Code MCP Setup

Configure Claude Code (or any MCP-compatible client) to connect to the Aether MCP server.

Prerequisites

  • Claude Code or another MCP client
  • Aether bridge running (see Quickstart)
  • Unity project with Aether SDK installed

Configuration

Claude Code

Claude Code uses a similar configuration to Cursor. Create a configuration file in your project:

Location: .claude/mcp.json or project settings

1{ 2 "mcpServers": { 3 "aether": { 4 "url": "ws://localhost:7891" 5 } 6 } 7}

Generic MCP Client

For any MCP client that supports WebSocket connections:

Connection Details:

  • Protocol: WebSocket (WS)
  • URL: ws://localhost:7891
  • Format: JSON-RPC 2.0

Example Connection (Node.js):

1const WebSocket = require('ws'); 2const ws = new WebSocket('ws://localhost:7891'); 3 4ws.on('open', () => { 5 // Send initialize request 6 ws.send(JSON.stringify({ 7 jsonrpc: "2.0", 8 id: 1, 9 method: "initialize", 10 params: { 11 protocolVersion: "2024-11-05", 12 capabilities: {}, 13 clientInfo: { 14 name: "your-client", 15 version: "1.0.0" 16 } 17 } 18 })); 19});

MCP Protocol

Aether implements the Model Context Protocol (MCP) specification. The server exposes:

Tools

All tools follow the MCP tools/call pattern:

1{ 2 "jsonrpc": "2.0", 3 "id": 1, 4 "method": "tools/call", 5 "params": { 6 "name": "aether_snapshot", 7 "arguments": { 8 "include_ui": true, 9 "event_count": 10 10 } 11 } 12}

Available Tools

  • aether_snapshot - Get current Unity state
  • aether_tail - Stream recent events
  • aether_mark - Create a markpoint
  • aether_getClip - Get a clip of events
  • aether_package - Create a capsule
  • aether_viewCapsule - View a capsule

See the Tools Reference for complete API documentation.

Verification

Test the connection:

  1. Connect to ws://localhost:7891
  2. Send an initialize request
  3. Call tools/list to see available tools
  4. Call tools/call with aether_snapshot to test
ℹ️Testing with curl

You can test the WebSocket connection using wscat:

1npm install -g wscat 2wscat -c ws://localhost:7891

Troubleshooting

Connection Issues

  • Verify bridge is running on port 7891
  • Check firewall settings
  • Ensure WebSocket protocol (not HTTP)

Protocol Errors

  • Verify JSON-RPC 2.0 format
  • Check request/response structure
  • Review MCP specification compliance

For more help, see the Troubleshooting Guide.

PreviousCursor
NextUnity SDK