Skip to content
MCP server

pyxsd

Let an agent inspect XSD schemas, validate XML and follow errors to the exact source line

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
1.4.0
Listing updated
3 days ago

About pyxsd

pyxsd is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

pyxsd is mainly a Python library that compiles XML Schema into classes and binds documents into typed trees. Its MCP server exposes that engine to an agent over stdio: load schema and XML inputs for a session, explore compiled schemas, validate, follow diagnostics to exact source occurrences, run bounded XPath queries, compare schemas, export records and read retained output files.

Safety defaults are conservative. Execution is disabled by default, and the one tool that runs supplied Python, pyxsd_preview_transform, needs an explicit trusted-local opt-in; the docs warn it runs with the launching user's privileges, not in a sandbox. Resource limits for file size, XML depth, worker count and deadlines are also off until enabled with --resource-limits. Output is kept in a store under the project root's .pyxsd/mcp, or in a temporary store with --no-persist.

Start it with uvx --from 'pyxsd[mcp]' pyxsd-mcp on Python 3.11 or newer. Installing the mcp-all extra adds Arrow-based projected records.

Install

Run in a terminal

claude mcp add pyxsd -- uvx pyxsd

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pyxsd": {
      "command": "uvx",
      "args": [
        "pyxsd"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pyxsd": {
      "command": "uvx",
      "args": [
        "pyxsd"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pyxsd": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pyxsd"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pyxsd": {
      "command": "uvx",
      "args": [
        "pyxsd"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pyxsd": {
      "command": "uvx",
      "args": [
        "pyxsd"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

pyxsd_preview_transform
Previews a user-supplied transform; requires the trusted-local execution opt-in.

What it does

Schema exploration
Inspect compiled XSD schemas and their types.
Diagnostics trail
Follow a validation issue to its exact source occurrence.
Bounded XPath
Run limited XPath queries against loaded documents.
Schema comparison
Compare schemas and export records.
Execution off by default
Transform previews need an explicit trusted-local opt-in.
Retained artifacts
Keeps bounded outputs in a project store for later reading.

Good for

  • Validate XML feeds against a multi-file schema
  • Debug why a document fails with exact locations
  • Diff two versions of an XSD
  • Preview a transform on sample documents
  • Export schema-derived records for analysis

Pricing

Open source

Prices change. Check pyxsd.knorby.com before you buy.

pyxsd FAQ

Is it safe to run?

Execution is disabled by default; trusted-local transform previews run unsandboxed and must be switched on at launch.

Which Python version?

Python 3.11 or newer.

Does it use the network?

The server is stdio-only and runs beside the client.

Where are outputs kept?

In <project-root>/.pyxsd/mcp unless you set --state-dir or --no-persist.

Is pyxsd free?

Yes. pyxsd is open source, so you can use and self-host it for free.

How do I add pyxsd to Claude Code?

Run this command in your terminal: claude mcp add pyxsd -- uvx pyxsd

What are the best alternatives to pyxsd?

The closest alternatives to pyxsd are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to pyxsd

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools