使用说明

项目简介

Kagi MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，它将 Kagi 搜索 API 集成为一个工具，使 LLM 客户端能够通过调用该工具执行网页搜索，获取最新的网络信息。

主要功能点

网页搜索工具: 提供 'search' 工具，允许 LLM 客户端发送搜索查询并获取 Kagi 搜索 API 的结果。
MCP 服务器: 遵循 MCP 协议，与 LLM 客户端通过 JSON-RPC 进行通信，提供标准化的上下文服务。
易于集成: 提供详细的安装和配置说明，方便用户将其集成到支持 MCP 协议的 LLM 客户端，如 Claude Desktop。

安装步骤

安装 uv: 根据您的操作系统，运行以下命令安装 uv 包管理器。

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆仓库: 使用 git 克隆 Kagi MCP 服务器仓库到本地。

git clone https://github.com/kagisearch/kagimcp.git
cd kagimcp

创建并激活虚拟环境: 使用 uv 创建 Python 虚拟环境并激活。

uv venv
source .venv/bin/activate   # MacOS/Linux
# 或
.venv/Scripts/activate  # Windows

安装依赖: 使用 uv 同步安装项目依赖。
```
uv sync
```

服务器配置

要将 Kagi MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要提供服务器的启动命令和参数。以下是配置示例，以 Claude Desktop 为例，您需要编辑 'claude_desktop_config.json' 文件。

找到 'claude_desktop_config.json' 文件: 在 Claude Desktop 应用中，通过 "Hamburger Menu -> File -> Settings -> Developer -> Edit Config" 找到该文件。

编辑 'claude_desktop_config.json' 文件: 在 'mcpServers' 字段中添加或修改 "kagi" 服务器的配置。

{
  "mcpServers": {
    "kagi": {
      "command": "uvx",  // 运行命令，uvx 是 uv 提供的可以直接执行虚拟环境中脚本的命令
      "args": ["kagimcp"], // 命令参数，kagimcp 会执行项目中的 server.py 文件
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"  // 环境变量，替换为您的 Kagi API 密钥
      }
    }
  }
}

参数说明:

'"kagi"': 服务器名称，您可以自定义。
'"command": "uvx"': 指定启动服务器的命令为 'uvx'，确保在虚拟环境中执行。
'"args": ["kagimcp"]': 指定传递给 'uvx' 命令的参数，'kagimcp' 会执行项目根目录下的 'kagimcp' 脚本，实际会运行 'src/kagimcp/server.py' 中的 'main' 函数。
'"env": {"KAGI_API_KEY": "YOUR_API_KEY_HERE"}': 设置环境变量，'KAGI_API_KEY' 用于 Kagi API 的身份验证，请替换 '"YOUR_API_KEY_HERE"' 为您真实的 Kagi API 密钥。您需要先申请 Kagi Search API 的访问权限。

基本使用方法

配置完成后，在 Claude Desktop 中，您可以向 Claude 提出需要网页搜索的问题。例如：

"Who was time's 2024 person of the year?"

Claude 将会调用 Kagi MCP 服务器提供的 'search' 工具进行网页搜索，并将搜索结果作为上下文信息来回答您的问题。

注意: 首次使用前，请确保您已申请并获得了 Kagi Search API 的访问权限，并将有效的 API 密钥配置到 'claude_desktop_config.json' 文件中。

关键词