Kagi MCP 服务器

安装说明

在开始之前，除非你只使用非搜索工具，否则请确保你有访问搜索 API 的权限。目前该 API 处于封闭测试阶段，需申请才能使用。请联系 support@kagi.com 获取邀请。

首先安装 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"

通过 Smithery 安装

你也可以通过 Smithery 为 Claude Desktop 安装 Kagi：

npx -y @smithery/cli install kagimcp --client claude

与 Claude Desktop 一起设置

// claude_desktop_config.json
// 可以通过以下方式找到位置：
// 汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE",
        "KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // 如果未设置环境变量，默认使用 "cecil" 引擎
      }
    }
  }
}

提出需要使用工具的问题

例如，搜索类问题：“2024 年时代杂志的年度人物是谁？”，或摘要类问题：“总结这个视频：https://www.youtube.com/watch?v=jNQXAC9IVRw”。

调试

运行：

npx @modelcontextprotocol/inspector uvx kagimcp

本地/开发设置说明

克隆仓库

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

安装依赖

首先安装 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"

然后安装 MCP 服务器依赖：

cd kagimcp

# 创建虚拟环境并激活它
uv venv

source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows

# 安装依赖
uv sync

与 Claude Desktop 一起设置

使用 MCP CLI SDK

# 如果尚未安装，请先运行 `pip install mcp[cli]`
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=API_KEY_HERE"

手动设置

# claude_desktop_config.json
# 可以通过以下方式找到位置：
# 汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "kagi": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp",
        "run",
        "kagimcp"
      ],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE",
        "KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // 如果未设置环境变量，默认使用 "cecil" 引擎
      }
    }
  }
}

提出需要使用工具的问题

例如，搜索类问题：“2024 年时代杂志的年度人物是谁？”，或摘要类问题：“总结这个视频：https://www.youtube.com/watch?v=jNQXAC9IVRw”。

调试

运行：

# 如果已安装 mcp cli (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py

# 如果未安装
npx @modelcontextprotocol/inspector \
      uv \
      --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp \
      run \
      kagimcp

然后在 http://localhost:5173 访问 MCP Inspector。你可能需要在 Inspector 的环境变量中添加你的 Kagi API 键，键名为 KAGI_API_KEY。

高级配置

• 日志级别可通过 FASTMCP_LOG_LEVEL 环境变量调整（例如 FASTMCP_LOG_LEVEL="ERROR"）
  • 相关问题：https://github.com/kagisearch/kagimcp/issues/4
• 摘要引擎可以通过 KAGI_SUMMARIZER_ENGINE 环境变量自定义（例如 KAGI_SUMMARIZER_ENGINE="daphne"）
  • 了解不同的摘要引擎 请点击这里