MCP2OSC

yyf/MCP2OSC

3.1

If you are the rightful owner of MCP2OSC and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP2OSC is a Model Context Protocol server designed to facilitate communication between MCP and OSC (OpenSoundControl) systems.

MCP2OSC

MCP2OSC is a MCP (Model Context Protocol) server for OSC (OpenSoundControl)

mcp2osc

Demo video

Watch the video

Installation

  1. Clone the repository

    git clone <repository-url>
cd MCP2OSC

  2. Install dependencies

    npm install

  3. Configure your LLM application Add to your Claude Desktop MCP configuration file, usually under "~/Library/Application\ Support/Claude" on macOS. Make sure you update paths accordingly.

    {
   "mcpServers": {
      "mcp2osc": {
         "command": "node",
         "args": ["/Users/.../MCP2OSC/mcp-server.js"],
         "cwd": "/Users/.../MCP2OSC",
         "env": {
         "OSC_HOST": "127.0.0.1",
         "OSC_SEND_PORT": "9500",
         "OSC_RECEIVE_PORT": "9501", 
         "WEBSOCKET_PORT": "8765",
         "WEBSOCKET_OSC_PORT": "9500",
         "MAX_OSC_MESSAGES": "2000",
         "OSC_LOG_ROTATION": "true"
         }
      }
   }
}

  4. Start the LLM application, i.e. Claude desktop application

  • Claude desktop application can be downloaded here: https://claude.ai/download
  • Restart Claude if you make any change to the claude config json file
  • Open the example MaxMSP or PureData patch and try the example prompts in Claude
  1. Example prompts
  • "What MCP tools are available"
  • "Ping MaxMSP at port 9500 then check if there is any response"
  • "Check received OSC messages"
  1. Optionally, start the web dashboard server for debugging 
    npm run mcp

License

MIT License - see LICENSE file for details