ReadAll XOSC MCP Server

Node.js server implementing Model Context Protocol (MCP) for reading all XOSC files from specified directories.

Features

• Recursively find and read all .xosc files in a directory
• Find and read all .xodr files in a specified folder
• Secure path validation
• Configurable directory permissions
• Exclude patterns support

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

API

Tools

• read_all_xosc_files

  • Recursively finds and reads all .xosc files from a directory
  • Input:
    • path (string): Directory to search
    • excludePatterns (string[]): Optional patterns to exclude from search
  • Returns contents of all XOSC files with paths as reference

• readPangyo_xodr_files

  • Finds and reads all .xodr files from a specified folder name
  • Input:
    • folderName (string): Folder name to search for .xodr files (relative to allowed directories)
  • Returns contents of all XODR files with paths as reference

• list_allowed_directories

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

Usage with OpenAI Assistant API or Claude

Docker

{
  "mcpServers": {
    "readall-xosc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/path/to/xosc/files,dst=/projects/xosc",
        "mcp/readall-xosc",
        "/projects"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "readall-xosc": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-readall-xosc",
        "/path/to/xosc/files"
      ]
    }
  }
}

Example Tool Call

// With OpenAI Assistant API
const response = await openai.beta.assistants.executeTask({
  assistant_id: "asst_...",
  thread_id: "thread_...",
  task: {
    tools: [{
      type: "mcp",
      serverId: "readall-xosc",
      resourceSpec: {
        resourceName: "file://system"
      }
    }]
  }
});

// Example tool call to read .xodr files in the Pangyo folder
await openai.beta.threads.runs.submitToolOutputs({
  thread_id: "thread_...",
  run_id: "run_...",
  tool_outputs: [{
    tool_call_id: "call_...",
    output: JSON.stringify({
      folderName: "pangyo"
    })
  }]
});

Build

Docker build:

docker build -t mcp/readall-xosc -f Dockerfile .

License

This MCP server is licensed under the MIT License.