SESA Tools MCP Server

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

Features

• Recursively find and read all .xosc files in a directory
• Recursively find and read all .xodr files in a directory
• 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

• read_all_xodr_files

  • Recursively finds and reads all .xodr files from a directory
  • Input:
    • path (string): Directory to search
    • excludePatterns (string[]): Optional patterns to exclude from search
  • 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": {
    "sesa-tools": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--mount", "type=bind,src=/path/to/files,dst=/projects/files",
        "mcp/sesa-tools",
        "/projects"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "sesa-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sesa-tools",
        "/path/to/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: "sesa-tools",
      resourceSpec: {
        resourceName: "file://system"
      }
    }]
  }
});

// The assistant can make tool calls to read XOSC and XODR files

Build

Docker build:

docker build -t mcp/sesa-tools -f Dockerfile .

License

This MCP server is licensed under the MIT License.