Jina AI MCP Server

Servidor MCP Jina AI

Um servidor MCP que fornece acesso aos poderosos serviços web da Jina AI através do Claude. Este servidor implementa três ferramentas principais:

• Leitura de páginas web e extração de conteúdo
• Pesquisa na web
• Verificação de fatos/contextualização

Recursos

Ferramentas

read_webpage

• Extrai conteúdo de páginas web em um formato otimizado para LLMs
• Suporta múltiplos formatos de saída (Padrão, Markdown, HTML, Texto, Screenshot, Pageshot)
• Opções para incluir links e imagens
• Capacidade de gerar texto alternativo para imagens
• Opções de controle de cache

search_web

• Pesquisa na web usando a API de busca da Jina AI
• Número configurável de resultados (padrão: 5)
• Suporte para retenção de imagens e geração de texto alternativo
• Múltiplos formatos de retorno (markdown, texto, html)
• Retorna resultados estruturados com títulos, descrições e conteúdo

fact_check

• Verifica afirmações usando o mecanismo de contextualização da Jina AI
• Fornece pontuações de factualidade e evidências de apoio
• Modo de análise aprofundada opcional para uma avaliação mais completa
• Retorna referências com citações-chave e classificação de apoio/contradição

Configuração

Pré-requisitos

Você precisará de uma chave de API da Jina AI para usar este servidor. Obtenha uma gratuitamente em https://jina.ai/

Instalação

Existem duas maneiras de usar este servidor:

Instalação via Smithery

Para instalar o Jina AI para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install jina-ai-mcp-server --client claude

Opção 1: NPX (Recomendado)

Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "jina-ai-mcp-server"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Opção 2: Instalação Local

1. Clone o repositório
2. Instale as dependências:

npm install

3. Compile o servidor:

npm run build

4. Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/jina-ai-mcp-server/dist/index.js"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Localização do Arquivo de Configuração

No MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

No Windows:

%APPDATA%/Claude/claude_desktop_config.json

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Tipos de Resposta da API

Todas as ferramentas retornam respostas JSON estruturadas que incluem:

• Códigos de status e metadados
• Conteúdo formatado com base no tipo de saída solicitado
• Informações de uso (contagens de tokens)
• Quando aplicável: imagens, links e metadados adicionais

Para informações detalhadas sobre o esquema, consulte schemas.ts.

Executando avaliações

O pacote de avaliações carrega um cliente MCP que então executa o arquivo index.ts, portanto não há necessidade de recompilar entre os testes. Você pode carregar variáveis de ambiente prefixando o comando npx. A documentação completa pode ser encontrada aqui.

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts index.ts