Interrogez des documents XML locaux à l'aide d'XPath et d'outils structurés dans un environnement sécurisé en lecture seule.
Aussi connu sous sezzlee/mcp, xml, @sezzlee/xml-mcp
- Étoiles
- 1
- Outils
- 7
- Téléchargements, 30 jours
- —
- Dernière version
- 0.5.1
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que Sezzlee XML MCP ?
Interrogez des documents XML locaux à l'aide d'XPath et d'outils structurés dans un environnement sécurisé en lecture seule. Il expose 7 outils, comme list_documents, describe_document, read_node.
Résumé généré à partir du README du projet
À propos du MCP server Sezzlee XML
Sezzlee XML fournit un environnement sécurisé et en lecture seule pour interroger des fichiers XML locaux. Il est conçu pour les développeurs qui doivent inspecter des données structurées au sein de fichiers tels que .xml, .xsd, .svg ou .config. Le serveur s'exécute localement via Node.js sur macOS, Linux ou Windows, et nécessite un chemin absolu vers un répertoire racine passé en argument de ligne de commande lors de la configuration.
Les utilisateurs interagissent avec le serveur via des outils spécifiques tels que select_xpath pour exécuter des expressions XPath 1.0 et project_records pour convertir des éléments répétés en lignes et colonnes. Il inclut également des outils pour lister les documents, décrire les structures, rechercher du texte brut et effectuer des agrégations comme des sommes ou des moyennes. Pour garantir la stabilité, le serveur utilise une architecture basée sur des workers où l'analyse syntaxique s'effectue dans un thread séparé.
Les performances sont gérées par un cache de documents qui conserve un nombre défini de fichiers en mémoire. Pour les fichiers très volumineux dépassant un plafond de 8 MiB, le serveur passe en mode chunked. Dans cet état, certains outils comme select_xpath et aggregate_document ne sont plus disponibles, bien que project_records reste fonctionnel pour permettre la poursuite de l'inspection des données.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Sezzlee XML MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Sezzlee XML MCP dans Claude Code
$ claude mcp add xml -- npx -y @sezzlee/xml-mcpInstaller Sezzlee XML MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"xml": {
"command": "npx",
"args": [
"-y",
"@sezzlee/xml-mcp"
]
}
}
}Installer Sezzlee XML MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"xml": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sezzlee/xml-mcp"
]
}
}
}Installer Sezzlee XML MCP dans VS Code CLI
$ code --add-mcp '{"name":"xml","type":"stdio","command":"npx","args":["-y","@sezzlee/xml-mcp"]}'Installer Sezzlee XML MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"xml": {
"command": "npx",
"args": [
"-y",
"@sezzlee/xml-mcp"
]
}
}
}Installer Sezzlee XML MCP dans Codex
$ codex mcp add xml -- npx -y @sezzlee/xml-mcpInstaller Sezzlee XML MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.xml] command = "npx" args = ["-y", "@sezzlee/xml-mcp"]
Installer Sezzlee XML MCP dans Gemini CLI
$ gemini mcp add -s user xml npx -- -y @sezzlee/xml-mcpInstaller Sezzlee XML MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"xml": {
"command": "npx",
"args": [
"-y",
"@sezzlee/xml-mcp"
]
}
}
}Outils MCP Sezzlee XML 7
Détectés depuis le READMElist_documentsdescribe_documentread_nodefind_in_documentselect_xpathproject_recordsaggregate_document
| list_documents | — | |
| describe_document | — | |
| read_node | — | |
| find_in_document | — | |
| select_xpath | — | |
| project_records | — | |
| aggregate_document | — |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblesezzlee/mcp is public and reachablegithub.com/sezzlee/mcp ↗Réussi
- Le nom du package correspond au dépôt source@sezzlee/xml-mcp names sezzlee/mcp as sourcenpmjs.com/package/@sezzlee/xml-mcp ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for @sezzlee/xml-mcpnpmjs.com/package/@sezzlee/xml-mcp/v/0.5.1#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-09github.com/sezzlee/mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @sezzlee/xml-mcpRéussi
- Aucun avis critique dans le package ou ses dépendances8 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHub@sezzlee/xml-mcp
A read-only, sandboxed MCP server that reads local XML documents.
It builds on @sezzlee/file-core; it does not depend on
@sezzlee/core and imports nothing from packages/lab/xml-lab.
Documentation: https://docs.sezzlee.app/docs/xml-mcp/introduction — a tutorial, task guides, and the tool, error-code and limit reference generated from this package.
Quick start
The root is the only argument, as an absolute path; there is no environment variable for it.
{
"mcpServers": {
"xml": {
"command": "npx",
"args": ["-y", "@sezzlee/xml-mcp", "/path/to/xml/root"]
}
}
}
With Claude Code:
claude mcp add xml -- npx -y @sezzlee/xml-mcp /path/to/xml/root
Readable extensions: .xml, .xsd, .xhtml, .svg, .csproj, .props, .targets, .config,
.resx. An extension like .config is not a guarantee of XML — a parse error there is expected
behavior. Requires Node.js 22 or 24 on macOS (x64, arm64), glibc Linux (x64, arm64) or Windows x64.
Tools
| Tool | What it does |
|---|---|
list_documents |
Lists readable XML documents under the root without parsing them |
describe_document |
Document element, every namespace with a stable alias, structure counts, repeated-element candidates, and an address read_node takes |
read_node |
A bounded, ordered slice of the tree as flat depth-first records |
find_in_document |
Literal text in text nodes, attribute values or both |
select_xpath |
One XPath 1.0 expression, exactly as written, with a typed result |
project_records |
A repeated element as rows and named columns, with a status per cell |
aggregate_document |
Counts, distinct counts and, with numericMode: binary64, sums and averages per group |
Every argument, error code and limit is listed in the reference.
A document over the 8 MiB resident ceiling is read in a reduced-capability chunked mode:
select_xpath, find_in_document and aggregate_document are unavailable there, while
project_records still works.
Configuration
createXmlMcpServer(root, options) takes two optional settings; the CLI
always uses the defaults.
| Option | Default | Meaning |
|---|---|---|
documentCacheSize |
4 |
Documents kept resident in memory at once (1–64) |
maxConcurrentListings |
4 |
Concurrent list_documents calls |
createXmlMcpServer(root, {
documentCacheSize: 4,
maxConcurrentListings: 4,
});
documentCacheSize (S) is the single knob; the worker pool's capacity is
derived as W = 2S, and the invariant W >= 2S-1 is pinned by a test — the
worker keeps a document alive while the store still holds it, so its map must
fit every store entry plus the one being adopted. This is a budget, not
enforcement: worker.resourceLimits bounds the JS heap, not WASM linear
memory, so exceeding the budget is a process crash rather than a clean
resource_limit error. Measured cost is 9.25-10.08x the source byte count,
so roughly 81 MiB resident per document at the 8 MiB ceiling; the default
S=4 is safe on the smallest supported host.
Rules
Parsing happens in the worker. The main process only ever holds a
serializable handle; a WASM pointer never crosses the boundary. No disposal
hook was needed on @sezzlee/file-core's document store because of this.
Layout follows the worker/host boundary. engine/ is the worker-side
graph and never names host/ or tools/; model/ and primitives/ are the
shared vocabulary between the two sides. index.ts, cli.ts,
xml-worker.ts and server.ts stay at the root — the tarball entry point,
bin, the CI tarball check and the ../package.json read respectively tie
them there.
The worker entry never imports the host surface. src/xml-worker.ts
only sees node:worker_threads, node:buffer, libxml2-wasm and a
type-only protocol; a lint rule enforces this. A worker returns a code
string, and the host side constructs the error object.
DOCTYPE is refused before parsing. The prolog scanner runs in the main
process; doc.dtd is only the second check. Measured: XML_PARSE_NO_XXE
does not block the internal DTD subset.
The worker's stdout never mixes into the parent's fd 1. It is isolated
with stdout: true; on stdio MCP, a single stray line breaks JSON-RPC.
diag is off in production and cannot be turned on through an
environment variable: it costs 24.9% and its raw report carries an engine
pointer.
Unsupported encodings are refused before parsing. The prolog scanner
applies the XML 1.0 Appendix F four-byte autodetection; the UCS-4 and EBCDIC
families get unsupported_encoding. Measured: the previous scanner missed
DOCTYPE in these families.
libxml2-wasm is pinned to exact 0.7.2. A caret would silently
invalidate the F0-01 integrity record; the CI tarball checker enforces this.
Development
pnpm turbo run build --filter=@sezzlee/xml-mcp
pnpm turbo run test --filter=@sezzlee/xml-mcp
pnpm turbo run check-types --filter=@sezzlee/xml-mcp
Run tests through Turbo, not pnpm --filter @sezzlee/xml-mcp test: the bare
filter skips dependsOn: ["^build"].
A change to a tool's arguments, an error code or a limit changes the generated reference in
apps/docs; run pnpm --filter @sezzlee/docs gen and commit the result, or
pnpm turbo run validate --filter=@sezzlee/docs fails.
Large-document tests are opt-in and skipped by default; set
SEZZLEE_XML_LARGE=1 to run them.
Questions sur Sezzlee XML MCP
Comment ajouter Sezzlee XML MCP à Claude Code ?
Exécutez claude mcp add xml -- npx -y @sezzlee/xml-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Sezzlee XML MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Sezzlee XML MCP fournit-il ?
Il expose 7 outils, dont list_documents, describe_document, read_node, find_in_document, select_xpath.
Quelles extensions de fichiers ce serveur peut-il lire ?
Le serveur prend en charge les fichiers .xml, .xsd, .xhtml, .svg, .csproj, .props, .targets, .config et .resx.
Comment le serveur gère-t-il les fichiers XML très volumineux ?
Les documents dépassant le plafond de 8 MiB en mémoire sont lus en mode « chunked » (par morceaux) avec des capacités réduites, rendant les outils select_xpath, find_in_document et aggregate_document indisponibles.
Le serveur est-il capable de modifier mes fichiers ?
Non, le serveur est conçu pour être en lecture seule et est restreint à un seul dossier via un environnement sandbox.