Skip to main content
Glama
Kagi MCP Server

Kagi MCP Server

Official
by kagisearch

Kagi MCP 服务器

设置说明

在开始之前,除非你只是使用非搜索工具,否则请确保你有权访问搜索 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

与 OpenAI 配合使用

Codex CLI

要将 Kagi MCP 服务器添加到 codex cli,你需要使用以下命令:

codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcp

这将把配置写入 ~/.codex/config.toml,因此如果你需要更新/轮换你的 API 密钥,请在再次运行 codex 之前在那里更新你的密钥。

Codex CLI 自带内置搜索(通过 --search 标志),但默认情况下是禁用的。因此,为了避免搜索和 Kagi 之间的冲突,只需不要启用它即可。

与 Claude 配合使用

Claude Desktop

// claude_desktop_config.json
// Can find location through:
// Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE",
        "KAGI_SUMMARIZER_ENGINE": "YOUR_ENGINE_CHOICE_HERE" // Defaults to "cecil" engine if env var not present
      }
    }
  }
}

Claude Code

使用以下命令添加 Kagi MCP 服务器(设置摘要引擎是可选的):

claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" KAGI_SUMMARIZER_ENGINE="YOUR_ENGINE_CHOICE_HERE" -- uvx kagimcp

现在 claude code 可以使用 Kagi MCP 服务器了。但是,claude code 默认自带网络搜索功能,这可能会与 Kagi 冲突。你可以在 claude code 设置文件 (~/.claude/settings.json) 中通过以下设置禁用 claude 的网络搜索功能:

{
  "permissions": {
    "deny": [
      "WebSearch"
    ]
  }
}

提出需要使用工具的查询

例如:搜索查询 "Who was time's 2024 person of the year?",或摘要查询 "summarize this video: https://www.youtube.com/watch?v=jNQXAC9IVRw"。

调试

运行:

npx @modelcontextprotocol/inspector uvx kagimcp

Related MCP server: sysauto Ask MCP Server

本地/开发设置说明

克隆仓库

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

# Create virtual environment and activate it
uv venv

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

# Install dependencies
uv sync

与 Claude Desktop 配合使用

使用 MCP CLI SDK

# `pip install mcp[cli]` if you haven't
mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=API_KEY_HERE"

手动设置

# claude_desktop_config.json
# Can find location through:
# Hamburger Menu -> File -> Settings -> Developer -> Edit Config
{
  "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" // Defaults to "cecil" engine if env var not present
      }
    }
  }
}

提出需要使用工具的查询

例如:搜索查询 "Who was time's 2024 person of the year?",或摘要查询 "summarize this video: https://www.youtube.com/watch?v=jNQXAC9IVRw"。

调试

运行:

# If mcp cli installed (`pip install mcp[cli]`)
mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py

# If not
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")

  • 摘要引擎可以使用 KAGI_SUMMARIZER_ENGINE 环境变量进行自定义(例如 KAGI_SUMMARIZER_ENGINE="daphne")

    • 在此处了解不同的摘要引擎

  • 可能有更安全的方式接入 MCP。一位用户在此处记录了一些详细信息

  • --http CLI 选项可用于开启可流式传输的 HTTP 传输。可以与 --port 和 --host 参数一起使用。

Available Tools

2 tools
kagi_extractA

Extract the content of a web page as markdown using the Kagi Extract API. Use this to read the full content of a page when needed.

Inputs: url (required). Returns: result

kagi_search_fetchA

Fetch web results for a query using the Kagi Search API. Use for general search and when the user explicitly tells you to 'fetch' results/information. Results are numbered so that a user may refer to a result by a specific number.

Inputs: query (required), after, limit, before, +7 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: one extracts page content, the other fetches search results. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tools follow a consistent 'kagi_' prefix combined with a verb_noun pattern ('extract' and 'search_fetch'), making naming predictable and clear.

    Tool Count3/5

    With only two tools, the set is minimal but still covers the core search and extract functionalities. However, it feels thin compared to typical MCP servers, which might offer more diverse operations.

    Completeness4/5

    The server provides the essential operations for its domain: searching and retrieving content. While additional tools like summarization could be useful, the current set is reasonably complete for basic tasks.

    Maintenance

    ActivityMaintained
    ResponsivenessMixed handling

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that enables Claude to perform web searches using Perplexity's API with intelligent model selection based on query intent and support for domain and recency filtering.
      6
      4
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      MCP server integrating the Kagi Search API to perform web searches using the kagi_search tool.
      1
      MIT