Write-XOSC MCP Server

Node.js server implementing Model Context Protocol (MCP) for saving OpenSCENARIO (.xosc) files.

Features

• Save XOSC content to files in allowed directories
• Validate file paths for security
• Generate proper save paths with correct extensions
• List available directories

Note: The server will only allow operations within directories specified via args.

API

Tools

• write_xosc

  • Save OpenSCENARIO content to a file
  • Inputs:
    • path (string): Where to save the file
    • content (string): XOSC content to write
    • overwrite (boolean, optional): Whether to overwrite existing file (default: false)
  • Automatically adds .xosc extension if not present
  • Creates parent directories if needed

• get_xosc_save_path

  • Generate a proper path for saving XOSC files
  • Inputs:
    • directory (string): Directory where you want to save the file
    • filename (string): Name of the file (without extension)
  • Returns validated path that can be used with write_xosc
  • Ensures proper .xosc extension

• list_allowed_directories

  • List all directories the server is allowed to access
  • No input required
  • Returns directories that this server can write to

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "write-xosc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir",
        "mcp/write-xosc",
        "/projects"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "write-xosc": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-write-xosc",
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Build

Docker build:

docker build -t mcp/write-xosc .

NPM install:

npm install -g @modelcontextprotocol/server-write-xosc

License

This MCP server is licensed under the MIT License.