Web Fetch

mcp-server-fetch-python

Um servidor MCP para buscar e transformar conteúdo web em vários formatos. Este servidor fornece ferramentas abrangentes para extrair conteúdo de páginas web, incluindo suporte para conteúdo renderizado por JavaScript e arquivos de mídia.

Recursos

Ferramentas

O servidor fornece quatro ferramentas especializadas:

• get-raw-text: Extrai conteúdo de texto bruto diretamente de URLs sem renderização de navegador

  • Argumentos:
    • url: URL da página web alvo (texto, JSON, XML, csv, tsv, etc.) (obrigatório)
  • Melhor usado para formatos de dados estruturados ou quando acesso rápido e direto é necessário

• get-rendered-html: Busca conteúdo HTML totalmente renderizado usando um navegador headless

  • Argumentos:
    • url: URL da página web alvo (obrigatório)
  • Essencial para aplicações web modernas e SPAs que exigem renderização JavaScript

• get-markdown: Converte o conteúdo da página web em Markdown bem formatado

  • Argumentos:
    • url: URL da página web alvo (obrigatório)
  • Preserva elementos estruturais enquanto fornece saída de texto limpa e legível

• get-markdown-from-media: Realiza extração de conteúdo com IA a partir de arquivos de mídia

  • Argumentos:
    • url: URL do arquivo de mídia alvo (imagens, vídeos) (obrigatório)
  • Utiliza visão computacional e OCR para análise de conteúdo visual
  • Requer uma OPENAI_API_KEY válida definida nas variáveis de ambiente
  • Retornará uma mensagem de erro se a chave da API não estiver definida ou se houver problemas no processamento do arquivo de mídia

Uso

Claude Desktop

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
No Windows: %APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch-python"
    ]
  }
}

Variáveis de Ambiente

As seguintes variáveis de ambiente podem ser configuradas:

• OPENAI_API_KEY: Necessária para usar a ferramenta get-markdown-from-media. Esta chave é necessária para análise de imagem e extração de conteúdo com IA.
• PYTHONIOENCODING: Defina como "utf-8" se encontrar problemas de codificação de caracteres na saída.
• MODEL_NAME: Especifica o nome do modelo a ser usado. O padrão é "gpt-4o".

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch-python"
    ],
    "env": {
        "OPENAI_API_KEY": "sk-****",
        "PYTHONIOENCODING": "utf-8",
        "MODEL_NAME": "gpt-4o",        
    }
  }
}

Instalação Local

Alternativamente, você pode instalar e executar o servidor localmente:

git clone https://github.com/tatn/mcp-server-fetch-python.git
cd mcp-server-fetch-python
uv sync
uv build

Em seguida, adicione a seguinte configuração ao arquivo de configuração do Claude Desktop:

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uv",
    "args": [
      "--directory",
      "path\\to\\mcp-server-fetch-python",  # Replace with actual path to the cloned repository
      "run",
      "mcp-server-fetch-python"
    ]
  }
}

Desenvolvimento

Depuração

Você pode iniciar o MCP Inspector usando npxcom os seguintes comandos:

npx @modelcontextprotocol/inspector uvx mcp-server-fetch-python

npx @modelcontextprotocol/inspector uv --directory path\\to\\mcp-server-fetch-python run mcp-server-fetch-python