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

一个基于 Node.js 实现的 Kagi 搜索代理服务器，通过使用 Kagi 搜索 API 为 AI 助手提供网络搜索功能。

特性

• 使用 Kagi API 进行网络搜索
• 支持多线程查询
• 格式化搜索结果
• 使用 TypeScript 和官方 MCP SDK 构建
• 预构建并直接使用（无需构建步骤）
• 独特的工具名称 (kagi_web_search) 以避免与其他 MCP 服务器冲突

设置指南

注意：首先确保你拥有访问搜索 API 的权限。目前该功能处于封闭测试阶段，需提前申请。请通过 support@kagi.com 联系获取邀请。

先决条件

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

快速开始（无需安装）

可以直接使用 npx 运行服务器：

KAGI_API_KEY=你的_api_密钥 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=你的_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_密钥

使用 AI 助手进行需要搜索的问题提问

例如：

Kagi 搜索代理服务器如何帮助我查找在线信息？

调试指南

使用 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 客户端配置一致