Servidor MCP Kagi | Awesome MCP Servers

Servidor MCP kagi-server

Servidor MCP para integração com a API Kagi

Este é um servidor MCP baseado em TypeScript que integra a API de Busca Kagi. Ele demonstra conceitos centrais do MCP ao fornecer:

Ferramentas para realizar buscas na web e outras operações usando a API Kagi (atualmente em beta privado)

Recursos

Ferramentas Implementadas

kagi_search - Realiza buscas na web usando Kagi
- Aceita uma string de consulta e um limite opcional como parâmetros
- Retorna resultados de busca da API Kagi

Ferramentas Planejadas (Ainda Não Implementadas)

kagi_summarize - Gera resumos de páginas web ou textos
kagi_fastgpt - Obtém respostas rápidas usando o FastGPT da Kagi
kagi_enrich - Busca resultados de notícias enriquecidos sobre tópicos específicos

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Configuração do Ambiente

Crie um arquivo .env no diretório raiz com sua chave da API Kagi:

KAGI_API_KEY=your_api_key_here

Certifique-se de adicionar .env ao seu arquivo .gitignore para manter sua chave de API segura.

Instalação

Instalação via Smithery

Para instalar o Kagi Server para Claude Desktop automaticamente via Smithery:

npx @smithery/cli install kagi-server --client claude

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": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

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

Uso

Depois que o servidor estiver em execução e conectado ao Claude Desktop, você pode usá-lo para realizar buscas na web. Por exemplo:

Peça ao Claude: "Você pode buscar informações sobre os últimos avanços em computação quântica?"
Claude usará a ferramenta kagi_search para buscar resultados da API Kagi.
Claude então resumirá ou analisará os resultados da busca para você.

Observação: As ferramentas planejadas (summarize, fastgpt, enrich) ainda não foram implementadas e não podem ser usadas.

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Algumas áreas para contribuição incluem:

Implementar as ferramentas planejadas (summarize, fastgpt, enrich)
Melhorar o tratamento de erros e a validação de entrada
Aprimorar a documentação e exemplos de uso

Licença

Este projeto é licenciado sob a Licença MIT.

Roadmap

Implementar a ferramenta kagi_summarize para resumo de páginas web e textos
Implementar a ferramenta kagi_fastgpt para respostas rápidas
Implementar a ferramenta kagi_enrich para buscar resultados de notícias enriquecidos
Melhorar o tratamento de erros e adicionar validação de entrada mais robusta
Adicionar exemplos de uso e documentação mais abrangentes
Publicar o pacote no npm para instalação fácil e uso com Claude Desktop e npx

Kagi

Documentação