Scythe MCP REAPER

Instructions

Get information about REAPER. Note: OSC is primarily for sending commands.
Use this to confirm connection is working.

Implementation Reference

• scythe_mcp/server/main.py:33-51 (handler)

  The main handler function for the 'get_session_info' tool. It is decorated with @mcp.tool(), which registers it with the MCP server. The function checks the REAPER OSC bridge connection and returns status information or an error message.

  @mcp.tool()
  def get_session_info(ctx: Context) -> str:
      """
      Get information about REAPER. Note: OSC is primarily for sending commands.
      Use this to confirm connection is working.
      """
      bridge = get_bridge()
      
      # Test OSC by sending a harmless command
      if bridge._osc_client:
          return """REAPER Connection:
  - OSC: Ready (localhost:8000)
  - Commands: File-based polling active
  
  To verify: Check that OSC is enabled in REAPER:
  Preferences → Control/OSC/Web → Add → OSC"""
      else:
          return "Error: OSC client not initialized. Install python-osc: uv add python-osc"