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