XPath MCP Server

Servidor MCP XPath

Servidor MCP para ejecutar consultas XPath sobre contenido XML.

Herramientas

1. xpath

   • Consulta contenido XML usando expresiones XPath
   • Entradas:
     • xml (cadena): El contenido XML a consultar
     • query (cadena): La consulta XPath a ejecutar
     • mimeType (opcional, cadena): El tipo MIME (p. ej. text/xml, application/xml, text/html, application/xhtml+xml)
   • Devuelve: El resultado de la consulta XPath como una cadena

2. xpathwithurl

   • Obtiene contenido de una URL y lo consulta usando expresiones XPath
   • Entradas:
     • url (cadena): La URL desde la que obtener contenido XML/HTML
     • query (cadena): La consulta XPath a ejecutar
     • mimeType (opcional, cadena): El tipo MIME (p. ej. text/xml, application/xml, text/html, application/xhtml+xml)
   • Devuelve: El resultado de la consulta XPath como una cadena

Instalación

Instalación mediante Smithery

Para instalar mcp-xpath para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @thirdstrandstudio/mcp-xpath --client claude

# Install dependencies
npm install

# Build the package
npm run build

Configuración

Uso con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

npx

{
  "mcpServers": {
    "xpath": {
      "command": "npx",
      "args": [
        "@thirdstrandstudio/mcp-xpath"
      ]
    }
  }
}

Node.js directo

{
  "mcpServers": {
    "xpath": {
      "command": "node",
      "args": [
        "/path/to/mcp-xpath/dist/index.js"
      ]
    }
  }
}

Reemplaza /path/to/mcp-xpath con la ruta real a tu repositorio.

Ejemplos

Consultar contenido XML

// Select all <item> elements from XML
const result = await callTool("xpath", {
  xml: "<root><item>value1</item><item>value2</item></root>",
  query: "//item/text()",
  mimeType: "text/xml"
});

Consultar contenido HTML

// Get all links from HTML
const result = await callTool("xpath", {
  xml: "<html><body><a href='link1.html'>Link 1</a><a href='link2.html'>Link 2</a></body></html>",
  query: "//a/@href",
  mimeType: "text/html"
});

Consultar contenido de una URL

// Get all links from a webpage
const result = await callTool("xpathwithurl", {
  url: "https://example.com",
  query: "//a/@href",
  mimeType: "text/html"
});

Desarrollo

# Install dependencies
npm install

# Start the server in development mode
npm start

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.