Jina AI Search

Servidor MCP Jina AI (Versão Node.js)

Um servidor MCP para Jina AI, fornecendo ferramentas para embeddings, reranking e geração. Esta é a versão Node.js.

Ferramentas Disponíveis

Este servidor fornece as seguintes ferramentas, que são interfaces diretas para as APIs da Jina AI Search Foundation:

• embeddings: Cria um vetor de embedding que representa o texto de entrada.
• rerank: Reordena uma lista de documentos com base em uma consulta.
• read: Extrai conteúdo limpo e amigável para LLM de um único URL de site.
• search: Realiza uma pesquisa na web e retorna resultados amigáveis para LLM.
• deepsearch: Combina pesquisa na web, leitura e raciocínio para investigação abrangente.
• segment: Divide o texto em partes semânticas ou conta tokens.
• classify: Realiza classificação zero-shot para texto.
• get_help: Retorna a documentação completa da API Jina AI usada para construir este servidor.

Conectando com Clientes MCP

Para conectar este servidor ao seu cliente compatível com MCP (como Cursor, shell-ai, etc.), você primeiro precisa publicar este pacote no NPM ou instalá-lo a partir de um caminho local.

Usando com npx (Após a Publicação)

Depois que o pacote for publicado no NPM, você pode configurar seu cliente para usá-lo com npx. Crie um arquivo .env com seu JINA_API_KEY no diretório onde você executa o cliente, ou certifique-se de que a variável de ambiente esteja definida.

Exemplo para mcpServers.json:

{
  "jina-ai-server": {
    "command": "npx",
    "args": [
      "jina-ai-mcp-server-nodejs"
    ],
    "env": {
      "JINA_API_KEY": "your_jina_api_key_here"
    }
  }
}

Nota: Passar a chave da API via env na configuração é mais seguro do que uma variável de ambiente global.

Desenvolvimento Local

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

   npm install
   

3. Crie um arquivo .env na raiz do projeto e adicione sua chave de API Jina AI.

   echo "JINA_API_KEY=your_jina_ai_api_key_here" > .env
   

4. Execute o servidor em modo de desenvolvimento:

   npm run dev
   

Docker

Compilando para Produção

Para compilar o código TypeScript para JavaScript:

npm run build

A saída compilada estará no diretório dist.

Você pode então executar o código compilado com:

npm start