Kagi Server Mcp Server

Cos'è mcp-servers-kagi?

Il ### mcp-servers-kagi è un'implementazione del server del Protocollo di Contesto del Modello (MCP) progettata specificamente per l'API di Kagi. Questo progetto mira a facilitare interazioni senza soluzione di continuità con i servizi di Kagi fornendo un robusto framework server che aderisce agli standard del Protocollo di Contesto del Modello. Permette agli sviluppatori di integrare le funzionalità di Kagi nelle loro applicazioni in modo efficiente.

Caratteristiche di mcp-servers-kagi

• Conformità MCP: Completamente conforme al Protocollo di Contesto del Modello, garantendo compatibilità con varie applicazioni e servizi.
• Integrazione API: Semplifica l'integrazione dell'API di Kagi, consentendo agli sviluppatori di sfruttare le sue funzionalità senza una configurazione estesa.
• Repository Pubblico: Il progetto è open-source e disponibile su GitHub, incoraggiando la collaborazione e i contributi dalla comunità.
• Sviluppo Attivo: Aggiornamenti e miglioramenti regolari vengono effettuati per migliorare funzionalità e prestazioni.
• Documentazione: Una documentazione completa è fornita per assistere gli sviluppatori nella comprensione e nell'utilizzo efficace del server.

Come utilizzare mcp-servers-kagi

1. Clona il Repository: Inizia clonando il repository mcp-servers-kagi da GitHub sul tuo computer locale.

   git clone https://github.com/ac3xx/mcp-servers-kagi.git
   

2. Installa le Dipendenze: Naviga nella directory del progetto e installa le dipendenze necessarie.

   cd mcp-servers-kagi
   npm install
   

3. Configurazione: Configura le impostazioni del server secondo le tue esigenze. Questo può includere chiavi API, endpoint e altri parametri.

4. Esegui il Server: Avvia il server per iniziare a gestire le richieste.

   npm start
   

5. Accedi all'API: Usa gli endpoint forniti per interagire con i servizi di Kagi attraverso il server MCP.

Domande Frequenti

Cos'è il Protocollo di Contesto del Modello?

Il Protocollo di Contesto del Modello è uno standard progettato per facilitare la comunicazione tra diversi sistemi e applicazioni. Fornisce un modo strutturato per scambiare dati e comandi, garantendo interoperabilità tra varie piattaforme.

mcp-servers-kagi è gratuito da usare?

Sì, mcp-servers-kagi è un progetto open-source rilasciato sotto la licenza MIT, che consente a chiunque di utilizzare, modificare e distribuire il software liberamente.

Come posso contribuire al progetto?

I contributi sono benvenuti! Puoi contribuire segnalando problemi, inviando richieste di funzionalità o creando pull request con miglioramenti o correzioni di bug. Si prega di fare riferimento alle linee guida per i contributi nel repository per ulteriori dettagli.

Dove posso trovare la documentazione?

La documentazione per mcp-servers-kagi è disponibile nel repository. Puoi anche visitare il sito ufficiale del Protocollo di Contesto del Modello per ulteriori risorse e informazioni.

Come posso segnalare un bug?

Se riscontri problemi durante l'utilizzo di mcp-servers-kagi, ti preghiamo di segnalarli nella pagina delle issue di GitHub del repository. Fornisci il maggior numero possibile di dettagli per aiutare i manutentori a risolvere il problema in modo efficace.

kagi-server MCP Server

MCP server for Kagi API integration

This is a TypeScript-based MCP server that integrates the Kagi Search API. It demonstrates core MCP concepts by providing:

• Tools for performing web searches and other operations using Kagi's API (currently in private beta)

Features

Implemented Tools

• kagi_search - Perform web searches using Kagi
  • Takes a query string and optional limit as parameters
  • Returns search results from Kagi's API

Planned Tools (Not Yet Implemented)

• kagi_summarize - Generate summaries of web pages or text
• kagi_fastgpt - Get quick responses using Kagi's FastGPT
• kagi_enrich - Fetch enriched news results on specific topics

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Environment Setup

Create a .env file in the root directory with your Kagi API key:

KAGI_API_KEY=your_api_key_here

Make sure to add .env to your .gitignore file to keep your API key secure.

Installation

Installing via Smithery

To install Kagi Server for Claude Desktop automatically via Smithery:

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

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On 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"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Usage

Once the server is running and connected to Claude Desktop, you can use it to perform web searches. For example:

1. Ask Claude: "Can you search for information about the latest advancements in quantum computing?"
2. Claude will use the kagi_search tool to fetch results from Kagi's API.
3. Claude will then summarize or analyze the search results for you.

Note: The planned tools (summarize, fastgpt, enrich) are not yet implemented and cannot be used.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Some areas for contribution include:

• Implementing the planned tools (summarize, fastgpt, enrich)
• Improving error handling and input validation
• Enhancing documentation and usage examples

License

This project is licensed under the MIT License.

Roadmap

• Implement kagi_summarize tool for webpage and text summarization
• Implement kagi_fastgpt tool for quick responses
• Implement kagi_enrich tool for fetching enriched news results
• Improve error handling and add more robust input validation
• Add more comprehensive usage examples and documentation
• Publish the package to npm for easy installation and use with Claude Desktop and npx