Kagiサーバー Mcpサーバー
概要
mcp-servers-kagiとは?
mcp-servers-kagiは、KagiのAPI専用に設計されたモデルコンテキストプロトコル(MCP)サーバーの実装です。このプロジェクトは、モデルコンテキストプロトコルの標準に準拠した堅牢なサーバーフレームワークを提供することで、Kagiのサービスとのシームレスなインタラクションを促進することを目的としています。これにより、開発者はKagiの機能を効率的にアプリケーションに統合できます。
mcp-servers-kagiの特徴
- MCP準拠:モデルコンテキストプロトコルに完全に準拠しており、さまざまなアプリケーションやサービスとの互換性を保証します。
- API統合:KagiのAPIの統合を簡素化し、開発者が広範な設定なしでその機能を活用できるようにします。
- 公開リポジトリ:このプロジェクトはオープンソースであり、GitHubで利用可能で、コミュニティからのコラボレーションや貢献を促進します。
- アクティブな開発:機能性とパフォーマンスを向上させるために、定期的な更新と改善が行われています。
- ドキュメント:開発者がサーバーを理解し、効果的に利用できるように、包括的なドキュメントが提供されています。
mcp-servers-kagiの使い方
-
リポジトリをクローンする:まず、GitHubからmcp-servers-kagiリポジトリをローカルマシンにクローンします。
git clone https://github.com/ac3xx/mcp-servers-kagi.git
-
依存関係をインストールする:プロジェクトディレクトリに移動し、必要な依存関係をインストールします。
cd mcp-servers-kagi npm install
-
設定:APIキー、エンドポイント、その他のパラメータに応じてサーバー設定を構成します。
-
サーバーを起動する:リクエストを処理するためにサーバーを起動します。
npm start
-
APIにアクセスする:提供されたエンドポイントを使用して、MCPサーバーを介してKagiのサービスと対話します。
よくある質問
モデルコンテキストプロトコルとは?
モデルコンテキストプロトコルは、異なるシステムやアプリケーション間の通信を促進するために設計された標準です。データやコマンドを交換するための構造化された方法を提供し、さまざまなプラットフォーム間の相互運用性を確保します。
mcp-servers-kagiは無料で使用できますか?
はい、mcp-servers-kagiはMITライセンスの下でリリースされたオープンソースプロジェクトであり、誰でも自由に使用、変更、配布できます。
プロジェクトに貢献するにはどうすればよいですか?
貢献は大歓迎です!問題の報告、機能リクエストの提出、改善やバグ修正を含むプルリクエストの作成などで貢献できます。詳細については、リポジトリの貢献ガイドラインを参照してください。
ドキュメントはどこで見つけられますか?
mcp-servers-kagiのドキュメントはリポジトリにあります。また、追加のリソースや情報については公式のモデルコンテキストプロトコルのウェブサイトを訪れることもできます。
バグを報告するにはどうすればよいですか?
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"
}
}
}
}