XPath MCP Server

Servidor MCP XPath

Servidor MCP para executar consultas XPath em conteúdo XML.

Ferramentas

1. xpath

   • Consulta conteúdo XML usando expressões XPath
   • Entradas:
     • xml (string): O conteúdo XML a ser consultado
     • query (string): A consulta XPath a ser executada
     • mimeType (opcional, string): O tipo MIME (ex.: text/xml, application/xml, text/html, application/xhtml+xml)
   • Retorna: O resultado da consulta XPath como uma string

2. xpathwithurl

   • Busca conteúdo de uma URL e o consulta usando expressões XPath
   • Entradas:
     • url (string): A URL para buscar conteúdo XML/HTML
     • query (string): A consulta XPath a ser executada
     • mimeType (opcional, string): O tipo MIME (ex.: text/xml, application/xml, text/html, application/xhtml+xml)
   • Retorna: O resultado da consulta XPath como uma string

Instalação

Instalando via Smithery

Para instalar o mcp-xpath para Claude Desktop automaticamente via Smithery:

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

# Install dependencies
npm install

# Build the package
npm run build

Configuração

Uso com Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

npx

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

Node.js direto

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

Substitua /path/to/mcp-xpath pelo caminho real do seu repositório.

Exemplos

Consultar conteúdo 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 conteúdo 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 conteúdo de URL

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

Desenvolvimento

# Install dependencies
npm install

# Start the server in development mode
npm start

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.