Servidor Kagi Servidor Mcp
Uma implementação de servidor do Protocolo de Contexto de Modelo para a API da Kagi
Visão geral
O que é mcp-servers-kagi?
O ### mcp-servers-kagi é uma implementação de servidor do Protocolo de Contexto de Modelo (MCP) projetada especificamente para a API da Kagi. Este projeto tem como objetivo facilitar interações sem interrupções com os serviços da Kagi, fornecendo uma estrutura de servidor robusta que adere aos padrões do Protocolo de Contexto de Modelo. Ele permite que os desenvolvedores integrem as funcionalidades da Kagi em suas aplicações de forma eficiente.
Recursos do mcp-servers-kagi
- Conformidade com o MCP: Totalmente compatível com o Protocolo de Contexto de Modelo, garantindo compatibilidade com várias aplicações e serviços.
- Integração de API: Simplifica a integração da API da Kagi, permitindo que os desenvolvedores aproveitem seus recursos sem uma configuração extensa.
- Repositório Público: O projeto é de código aberto e está disponível no GitHub, incentivando a colaboração e contribuições da comunidade.
- Desenvolvimento Ativo: Atualizações e melhorias regulares são feitas para aprimorar a funcionalidade e o desempenho.
- Documentação: Documentação abrangente é fornecida para ajudar os desenvolvedores a entender e utilizar o servidor de forma eficaz.
Como Usar o mcp-servers-kagi
-
Clone o Repositório: Comece clonando o repositório mcp-servers-kagi do GitHub para sua máquina local.
git clone https://github.com/ac3xx/mcp-servers-kagi.git
-
Instale Dependências: Navegue até o diretório do projeto e instale as dependências necessárias.
cd mcp-servers-kagi npm install
-
Configuração: Configure as configurações do servidor de acordo com suas necessidades. Isso pode incluir chaves de API, endpoints e outros parâmetros.
-
Execute o Servidor: Inicie o servidor para começar a lidar com solicitações.
npm start
-
Acesse a API: Use os endpoints fornecidos para interagir com os serviços da Kagi através do servidor MCP.
Perguntas Frequentes
O que é o Protocolo de Contexto de Modelo?
O Protocolo de Contexto de Modelo é um padrão projetado para facilitar a comunicação entre diferentes sistemas e aplicações. Ele fornece uma maneira estruturada de trocar dados e comandos, garantindo interoperabilidade entre várias plataformas.
O mcp-servers-kagi é gratuito para usar?
Sim, o mcp-servers-kagi é um projeto de código aberto lançado sob a licença MIT, permitindo que qualquer pessoa use, modifique e distribua o software livremente.
Como posso contribuir para o projeto?
Contribuições são bem-vindas! Você pode contribuir relatando problemas, enviando solicitações de recursos ou criando pull requests com melhorias ou correções de bugs. Consulte as diretrizes de contribuição no repositório para mais detalhes.
Onde posso encontrar a documentação?
A documentação do mcp-servers-kagi está disponível no repositório. Você também pode visitar o site oficial do Protocolo de Contexto de Modelo para recursos e informações adicionais.
Como posso relatar um bug?
Se você encontrar algum problema ao usar o mcp-servers-kagi, por favor, relate-os na página de problemas do GitHub do repositório. Forneça o máximo de detalhes possível para ajudar os mantenedores a resolver o problema de forma eficaz.
Detalhe
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 textkagi_fastgpt
- Get quick responses using Kagi's FastGPTkagi_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:
- Ask Claude: "Can you search for information about the latest advancements in quantum computing?"
- Claude will use the
kagi_search
tool to fetch results from Kagi's API. - 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
Configuração do Servidor
{
"mcpServers": {
"mcp-servers-kagi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ac3xx--mcp-servers-kagi--mcp-servers-kagi",
"node ./build/index.js"
],
"env": {
"KAGI_API_KEY": "kagi-api-key"
}
}
}
}