Kagi 伺服器 Mcp 伺服器

什麼是 mcp-servers-kagi？

mcp-servers-kagi 是一個專為 Kagi 的 API 設計的模型上下文協議（MCP）伺服器實現。該項目的目的是通過提供一個符合模型上下文協議標準的穩健伺服器框架，促進與 Kagi 服務的無縫互動。它允許開發者有效地將 Kagi 的功能整合到他們的應用中。

mcp-servers-kagi 的特點

• MCP 合規性：完全符合模型上下文協議，確保與各種應用和服務的兼容性。
• API 整合：簡化 Kagi API 的整合，讓開發者能夠在不需大量設置的情況下利用其功能。
• 公開庫：該項目是開源的，並在 GitHub 上可用，鼓勵社區的合作和貢獻。
• 積極開發：定期進行更新和改進，以增強功能和性能。
• 文檔：提供全面的文檔，以幫助開發者有效理解和使用伺服器。

如何使用 mcp-servers-kagi

1. 克隆庫：首先從 GitHub 克隆 mcp-servers-kagi 庫到你的本地機器。

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

2. 安裝依賴：導航到項目目錄並安裝必要的依賴。

   cd mcp-servers-kagi
   npm install
   

3. 配置：根據你的需求配置伺服器設置。這可能包括 API 密鑰、端點和其他參數。

4. 啟動伺服器：啟動伺服器以開始處理請求。

   npm start
   

5. 訪問 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 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