MCP Servers Kagi

🚀 Kagi 服務器 MCP 服務器

Kagi 服務器 MCP 服務器是一個集成了 Kagi API 的 MCP 服務器。它基於 TypeScript 構建，通過實現核心 MCP 概念，可使用 Kagi 進行網絡搜索等操作，為用戶提供便捷的搜索服務。

🚀 快速開始

Kagi 服務器 MCP 服務器是一個集成 Kagi 搜索 API 的 MCP 服務器，藉助它能使用 Kagi 進行網絡搜索等操作。以下是使用前的準備步驟。

✨ 主要特性

已實現的工具

• kagi_search - 使用 Kagi 進行網絡搜索
  • 可接受查詢字符串和可選的限制參數。
  • 能返回 Kagi API 的搜索結果。

計劃中的工具（尚未實現）

• kagi_summarize - 生成網頁或文本的摘要。
• kagi_fastgpt - 使用 Kagi 的 FastGPT 獲取快速響應。
• kagi_enrich - 檢索特定主題的豐富新聞結果。

📦 安裝指南

安裝依賴

npm install

構建服務器

npm run build

帶有自動重建功能的開發

npm run watch

通過 Smithery 安裝

要通過 Smithery 自動安裝 Kagi Server for Claude Desktop，可使用以下命令：

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

配置服務器

要與 Claude Desktop 配合使用，需添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 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"
      }
    }
  }
}

💻 使用示例

基礎用法

一旦服務器運行並連接到 Claude Desktop，您就可以使用它進行網絡搜索。例如：

1. 問 Claude："你能搜索關於量子計算最新進展的信息嗎？"
2. Claude 將使用 kagi_search 工具從 Kagi 的 API 獲取結果。
3. Claude 然後會對搜索結果進行總結或分析。

⚠️ 重要提示

計劃中的工具（摘要、fastgpt、enrich）尚未實現，無法使用。

🔧 技術細節

這是一個基於 TypeScript 的 MCP 服務器，集成了 Kagi 搜索 API。它通過實現核心 MCP 概念來展示功能，使用 Kagi 作為進行網絡搜索和其他操作的工具，提供查詢字符串和可選限制參數，並返回 Kagi API 的搜索結果。

📄 許可證

該項目在 MIT 許可證下發布。

📚 詳細文檔

環境配置

在項目根目錄創建一個 .env 文件，包含您的 Kagi API 密鑰：

KAGI_API_KEY=your_api_key_here

請確保將 .env 添加到 .gitignore 文件中以保持安全。

調試

由於 MCP 服務器通過標準輸入/輸出進行通信，調試可能具有挑戰性。我們建議使用 MCP Inspector，它作為包腳本提供：

npm run inspector

Inspector 將提供訪問瀏覽器調試工具的 URL。

貢獻

歡迎貢獻！請隨意提交 Pull Request。一些可以貢獻的領域包括：

• 實現計劃中的工具（摘要、fastgpt、enrich）。
• 改善錯誤處理和輸入驗證。
• 提高文檔的質量和示例。

路線圖

• 實現 kagi_summarize 工具用於網頁和文本摘要。
• 實現 kagi_fastgpt 工具以獲取快速響應。
• 實現 kagi_enrich 工具以獲取豐富新聞結果。
• 改善錯誤處理並添加更 robust 的輸入驗證。
• 添加更多全面的使用示例和文檔。
• 發佈到 npm 以便輕鬆安裝和與 Claude Desktop 和 npx 使用。