Kagi MCP Server (Node.js)

Kagi MCP 服务（Node.js）

Kagi MCP 服务的 Node.js 实现，通过 Kagi 搜索 API 为 AI 助手提供网页搜索功能。

功能

• 使用 Kagi API 进行网页搜索
• 支持并行执行多个搜索查询
• 格式化搜索结果
• 使用 TypeScript 和官方 MCP SDK 构建
• 已预构建，可直接使用（无需构建步骤）
• 使用唯一工具名称（kagi_web_search），避免与其他 MCP 服务冲突

设置说明

首先，请确保你可以使用搜索 API。该 API 目前处于封闭测试阶段，可按需申请。请联系 [email protected] 获取邀请。

前提条件

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

快速开始（无需安装）

你可以使用 npx 直接运行服务，无需安装：

KAGI_API_KEY=your_api_key_here npx github:elliottlawson/kagi-mcp-server

安装

1. 克隆仓库：

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

2. 直接运行（无需构建）：

KAGI_API_KEY=your_api_key_here node build/index.js

如果你想修改代码，则需要安装依赖并重新构建：

npm install
npm run build

在 Claude Desktop 中设置

将以下 MCP 配置添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "kagi": {
      "command": "npx",
      "args": ["github:elliottlawson/kagi-mcp-server"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

或者，如果你已克隆仓库：

{
  "mcpServers": {
    "kagi": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_REPO/build/index.js"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

在 Cursor 中设置

1. 前往 Cursor Settings -> MCP -> Add new MCP server
2. 配置 MCP：
   • 名称：Kagi Search
   • 类型：command
   • 命令：npx github:elliottlawson/kagi-mcp-server
   • 环境变量：KAGI_API_KEY=YOUR_API_KEY_HERE

在 Claude Code 中设置

claude mcp add --transport stdio kagi --env KAGI_API_KEY=YOUR_API_KEY_HERE -- npx github:elliottlawson/kagi-mcp-server

向 AI 助手提出需要搜索的问题

例如：“使用 Kagi 搜索 2024 年《时代》年度人物是谁？”

AI 将使用 kagi_web_search 工具执行搜索，避免与其他搜索工具冲突。

调试

运行 MCP Inspector 调试服务：

npx @modelcontextprotocol/inspector npx github:elliottlawson/kagi-mcp-server

或者，如果你已克隆仓库：

npx @modelcontextprotocol/inspector node build/index.js

然后访问 http://localhost:5173 打开 MCP Inspector。你可能需要在 Inspector 的环境变量中添加 Kagi API 密钥，变量名为 KAGI_API_KEY。

开发

项目结构

kagi-mcp-server/
├── src/
│   ├── index.ts           # Main entry point
│   ├── kagi-client.ts     # Kagi API client
│   └── utils/
│       └── formatter.ts   # Result formatting utilities
├── build/                 # Pre-built JavaScript files
│   ├── index.js           # Executable entry point
│   ├── kagi-client.js
│   └── utils/
│       └── formatter.js
├── package.json
├── tsconfig.json
└── README.md

构建

如果你修改了 TypeScript 代码，请重新构建项目：

npm run build

运行

运行服务：

npm start

备注

• 可以通过 DEBUG 环境变量调整日志级别
• 服务使用 stdio 与 MCP 客户端通信
• 仓库中包含预构建的 JavaScript 文件，因此使用时无需构建
• 工具命名为 kagi_web_search，以避免与其他可能使用通用 search 工具的 MCP 服务冲突