Kagi MCP Server

🚀 Kagi 搜索代理服務器（Node.js）

Kagi 搜索代理服務器基於 Node.js 實現，藉助 Kagi 搜索 API 為 AI 助手賦予網絡搜索能力，有效解決 AI 助手獲取即時網絡信息的問題，提升其信息檢索的準確性和全面性。

🚀 快速開始

Kagi 搜索代理服務器可讓 AI 助手輕鬆實現網絡搜索功能。使用前，請確保你擁有訪問搜索 API 的權限，目前該功能處於封閉測試階段，需提前申請，可通過 support@kagi.com 聯繫獲取邀請。

無需安裝直接運行

可以直接使用 npx 運行服務器：

KAGI_API_KEY=你的_api_密鑰 npx github:elliottlawson/kagi-mcp-server

使用 AI 助手進行需要搜索的問題提問

例如：

Kagi 搜索代理服務器如何幫助我查找在線信息？

✨ 主要特性

• 使用 Kagi API 進行網絡搜索
• 支持多線程查詢
• 格式化搜索結果
• 使用 TypeScript 和官方 MCP SDK 構建
• 預構建並直接使用（無需構建步驟）
• 獨特的工具名稱 (kagi_web_search) 以避免與其他 MCP 服務器衝突

📦 安裝指南

先決條件

• Node.js 18 或更高版本
• Kagi API 密鑰

克隆倉庫並運行

1. 克隆倉庫：

git clone https://github.com/elliottlawson/kagi-mcp-server.git
cd kagi-mcp-server

2. 直接運行（無需構建）：

KAGI_API_KEY=你的_api_密鑰 node build/index.js

修改代碼後的操作

如果你需要修改代碼，則需安裝依賴並重新構建：

npm install
npm run build

在 Claude Desktop 中配置

在你的 Claude Desktop 配置中添加以下 MCP 設置：

{
  "mcpServers": {
    "kagi": {
      "command": "npx",
      "args": ["github:elliottlawson/kagi-mcp-server"],
      "env": {
        "KAGI_API_KEY": "你的_api_密鑰"
      }
    }
  }
}

或者如果你已經克隆了倉庫：

{
  "mcpServers": {
    "kagi": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_REPO/build/index.js"],
      "env": {
        "KAGI_API_KEY": "你的_api_密鑰"
      }
    }
  }
}

在 Cursor 中配置

1. 進入 Cursor 設置 -> MCP -> 添加新的 MCP 服務器
2. 配置你的 MCP：
   • 名稱：Kagi 搜索
   • 類型：命令
   • 命令：npx github:elliottlawson/kagi-mcp-server
   • 環境變量：KAGI_API_KEY=你的_api_密鑰

📚 詳細文檔

調試指南

使用 MCP Inspector 工具調試：

# 安裝工具：npm install -g @kagi/mcp-inspector
# 啟動調試：mcp-inspector

在 Inspector 中添加環境變量：

• 點擊頂部菜單欄的 Edit -> Configuration
• 添加 KAGI_API_KEY 變量，值為你的 API 密鑰

開發指南

項目結構

src/
├── server.ts      # 主服務器文件
└── search.ts     # 搜索功能實現
build/             # 構建輸出目錄

構建與運行

npm run build    # 構建項目
npm start        # 運行構建後的產物

🔧 技術細節

• 服務器通過標準輸入輸出進行通信
• 日誌級別可通過環境變量 LOG_LEVEL 調整，默認為 info
• 工具名稱 kagi_web_search 確保與 MCP 客戶端配置一致