MCP NPX Fetch

MCP NPX Fetch

---

🚀 Recursos

• 🌐 Busca Universal de Conteúdo: Suporta formatos HTML, JSON, texto simples e Markdown
• 🔒 Suporte a Cabeçalhos Personalizados: Adicione autenticação e cabeçalhos personalizados às suas requisições
• 🛠 Transformações Integradas: Conversão automática entre formatos
• ⚡ Alto Desempenho: Construído com recursos modernos de JavaScript e otimizado para velocidade
• 🔌 Compatível com MCP: Integra-se perfeitamente com Claude Desktop e outros clientes MCP
• 🎯 Type-Safe: Escrito em TypeScript com definições de tipos completas

📦 Instalação

Instalação Global via NPM

npm install -g @tokenizin/mcp-npx-fetch

Uso Direto com NPX

npx @tokenizin/mcp-npx-fetch

📚 Documentação

Ferramentas Disponíveis

fetch_html

Busca e retorna conteúdo HTML bruto de qualquer URL.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_json

Busca e analisa dados JSON de qualquer URL.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_txt

Busca e retorna conteúdo de texto simples limpo, removendo tags HTML e scripts.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_markdown

Busca conteúdo e o converte em Markdown bem formatado.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

🔧 Uso

Uso via CLI

Inicie o servidor MCP diretamente:

mcp-npx-fetch

Ou via npx:

npx @tokenizin/mcp-npx-fetch

Integração com Claude Desktop

1. Localize o arquivo de configuração do Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Adicione a seguinte configuração ao seu objeto mcpServers:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@tokenizin/mcp-npx-fetch"],
      "env": {}
    }
  }
}

💻 Desenvolvimento Local

1. Clone o repositório:

git clone https://github.com/tokenizin-agency/mcp-npx-fetch.git
cd mcp-npx-fetch

2. Instale as dependências:

npm install

3. Inicie o modo de desenvolvimento:

npm run dev

4. Execute os testes:

npm test

🛠 Stack Técnico

• Model Context Protocol SDK - Funcionalidade principal do MCP
• JSDOM - Análise e manipulação de HTML
• Turndown - Conversão de HTML para Markdown
• TypeScript - Segurança de tipos e recursos modernos de JavaScript
• Zod - Validação de tipos em tempo de execução

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

1. Faça um fork do repositório
2. Crie sua branch de funcionalidade (git checkout -b feature/AmazingFeature)
3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
4. Envie para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

---