AI导哈

网页搜索服务器

一个基于Node.js的Kagi MCP服务器实现，通过Kagi搜索API为AI助手提供网页搜索能力。

  • by elliottlawson
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 elliottlawson/kagi-mcp-server

使用说明

Kagi MCP服务器（Node.js）

Kagi MCP服务器的Node.js实现，使用Kagi搜索API为人工智能助手提供网络搜索功能。

特性

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

安装说明

在做任何事情之前，请确保您可以访问搜索API。它目前处于内测阶段，可应要求提供。请联系support@kagi.com邀请。

先决条件

  • 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
  1. 直接运行（无需构建）：
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"
      }
    }
  }
}

使用光标进行设置

  1. 转到光标设置->MCP->添加新的MCP服务器
  2. 配置您的MCP：
    • 名称：Kagi搜索
    • 类型：命令
    • 命令：npx github：elliottlawson/kagi mcp服务器
    • 环境变量：KAGI_API_KEY=YOUR_API_KEY_HERE

使用Claude代码进行设置

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检查器调试服务器：

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

或者，如果您已经克隆了存储库：

npx @modelcontextprotocol/inspector node build/index.js

然后访问MCP检查器 http://localhost:5173.您可能需要在下的检查器中的环境变量中添加您的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 为了避免与可能具有通用配置的其他MCP服务器发生冲突 search 工具

相关 MCP