使用说明

项目简介

Kagi Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它集成了 Kagi Search API，旨在为大型语言模型 (LLM) 客户端提供网页搜索功能。通过该服务器，LLM 应用可以调用 Kagi 搜索 API 获取最新的网络信息。

主要功能点

网页搜索工具 (kagi_search): 允许 LLM 客户端通过 Kagi Search API 执行网页搜索，并返回搜索结果。目前仅实现了 'kagi_search' 工具，未来计划实现更多 Kagi API 提供的功能。

安装步骤

安装依赖: 确保你的环境中安装了 Node.js 和 npm。克隆仓库到本地后，在项目根目录下运行 'npm install' 安装项目依赖。
配置环境变量: 在项目根目录下创建 '.env' 文件，并添加你的 Kagi API 密钥。
```
KAGI_API_KEY=your_api_key_here
```
构建服务器: 运行 'npm run build' 命令编译 TypeScript 代码。

服务器配置

为了让 MCP 客户端（如 Claude Desktop）连接到 Kagi Server，需要配置客户端的服务器列表。以下是 Claude Desktop 的配置示例，你需要将 '/path/to/kagi-server/build/index.js' 替换为 'kagi-server' 构建后的 'index.js' 文件的实际路径。

{
  "mcpServers": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

配置参数说明:

'server name': 'kagi-server' - 服务器的名称，在客户端配置中用于标识该服务器。
'command': '/path/to/kagi-server/build/index.js' - 启动 MCP 服务器的命令，指向构建后的 'index.js' 文件。请根据实际文件路径进行修改。
'env': 环境变量配置。
- 'KAGI_API_KEY': Kagi API 密钥，需要替换为你在 '.env' 文件中设置的密钥。

基本使用方法

启动服务器: 在项目根目录下运行 'npm run watch' (开发模式，自动重建) 或 'npm run start' (生产模式，需要先 'npm run build') 启动 Kagi Server。服务器将通过 stdio 与 MCP 客户端通信。
在 LLM 应用中使用: 配置好 MCP 客户端后，即可在 LLM 应用中通过 'kagi_search' 工具进行网页搜索。例如，在 Claude 中，你可以提问类似 “使用 kagi_search 搜索关于量子计算的最新进展” 的问题，Claude 将调用 'kagi_search' 工具并返回搜索结果。

关键词