🚀 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
安装步骤
- 克隆仓库：
git clone https://github.com/elliottlawson/kagi-mcp-server.git
cd kagi-mcp-server
- 直接运行（无需构建）：
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 中配置
- 进入 Cursor 设置 -> MCP -> 添加新的 MCP 服务器。
- 配置你的 MCP：
- 名称：Kagi 搜索
- 类型：命令
- 命令：npx github:elliottlawson/kagi-mcp-server
- 环境变量：KAGI_API_KEY=你的_api_密钥
使用 AI 助手进行需要搜索的问题提问
例如：
Kagi 搜索代理服务器如何帮助我查找在线信息？
🔧 技术细节
项目结构
src/
├── server.ts # 主服务器文件
└── search.ts # 搜索功能实现
build/ # 构建输出目录
构建与运行
npm run build # 构建项目
npm start # 运行构建后的产物
📚 详细文档
调试指南
使用 MCP Inspector 工具调试：
# 安装工具：npm install -g @kagi/mcp-inspector
# 启动调试：mcp-inspector
在 Inspector 中添加环境变量：
- 点击顶部菜单栏的
Edit -> Configuration。 - 添加
KAGI_API_KEY变量，值为你的 API 密钥。
注意事项
- 服务器通过标准输入输出进行通信。
- 日志级别可通过环境变量
LOG_LEVEL调整，默认为info。 - 工具名称
kagi_web_search确保与 MCP 客户端配置一致。