Kagi Сервер Mcp Сервер
Реализация сервера протокола контекста модели для API Kagi
Обзор
Что такое mcp-servers-kagi?
mcp-servers-kagi — это реализация сервера Model Context Protocol (MCP), разработанная специально для API Kagi. Этот проект направлен на упрощение взаимодействия с сервисами Kagi, предоставляя надежную серверную структуру, соответствующую стандартам Model Context Protocol. Он позволяет разработчикам эффективно интегрировать функциональность Kagi в свои приложения.
Особенности mcp-servers-kagi
- Соответствие MCP: Полное соответствие Model Context Protocol, обеспечивающее совместимость с различными приложениями и сервисами.
- Интеграция API: Упрощает интеграцию API Kagi, позволяя разработчикам использовать его функции без обширной настройки.
- Публичный репозиторий: Проект является открытым исходным кодом и доступен на GitHub, что способствует сотрудничеству и вкладу со стороны сообщества.
- Активная разработка: Регулярные обновления и улучшения для повышения функциональности и производительности.
- Документация: Предоставляется исчерпывающая документация, чтобы помочь разработчикам понять и эффективно использовать сервер.
Как использовать mcp-servers-kagi
-
Клонируйте репозиторий: Начните с клонирования репозитория mcp-servers-kagi с GitHub на ваш локальный компьютер.
git clone https://github.com/ac3xx/mcp-servers-kagi.git
-
Установите зависимости: Перейдите в каталог проекта и установите необходимые зависимости.
cd mcp-servers-kagi npm install
-
Конфигурация: Настройте параметры сервера в соответствии с вашими требованиями. Это может включать API-ключи, конечные точки и другие параметры.
-
Запустите сервер: Запустите сервер, чтобы начать обработку запросов.
npm start
-
Доступ к API: Используйте предоставленные конечные точки для взаимодействия с сервисами Kagi через сервер MCP.
Часто задаваемые вопросы
Что такое Model Context Protocol?
Model Context Protocol — это стандарт, разработанный для упрощения общения между различными системами и приложениями. Он предоставляет структурированный способ обмена данными и командами, обеспечивая совместимость между различными платформами.
Является ли mcp-servers-kagi бесплатным для использования?
Да, mcp-servers-kagi — это проект с открытым исходным кодом, выпущенный под лицензией MIT, что позволяет любому использовать, модифицировать и распространять программное обеспечение бесплатно.
Как я могу внести вклад в проект?
Вклад приветствуется! Вы можете внести свой вклад, сообщая о проблемах, отправляя запросы на новые функции или создавая запросы на изменение с улучшениями или исправлениями ошибок. Пожалуйста, ознакомьтесь с руководством по внесению вклада в репозитории для получения дополнительной информации.
Где я могу найти документацию?
Документация для mcp-servers-kagi доступна в репозитории. Вы также можете посетить официальный сайт Model Context Protocol для получения дополнительных ресурсов и информации.
Как я могу сообщить об ошибке?
Если вы столкнулись с какими-либо проблемами при использовании mcp-servers-kagi, пожалуйста, сообщите об этом на странице проблем GitHub репозитория. Укажите как можно больше деталей, чтобы помочь поддерживающим эффективно решить проблему.
Деталь
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
Конфигурация сервера
{
"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"
}
}
}
}