STARWARCLOUD STARWAR.AI
返回市场
卡吉MCP

卡吉MCP

作者：kagisearch224 星标更新：2025-11-17
安装使用来源：spider==github.com

项目介绍

Kagi MCP 服务器

smithery 徽章

<a href="https://glama.ai/mcp/servers/xabrrs4bka"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=302448140,3963446373&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Kagi Server MCP 服务器" /> </a>

安装指南

在进行任何操作之前，请确保您有访问搜索 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 安装 Kagi for Claude Desktop：

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

使用 OpenAI 设置

Codex CLI

要将 Kagi mcp 服务器添加到 codex cli，您需要使用以下命令：

codex mcp add kagi --env KAGI_API_KEY=<您的 API 密钥> -- uvx kagimcp

这将在 ~/.codex/config.toml 中写入配置，因此如果您需要更新或轮换 API 密钥，请在再次运行 codex 之前在此处更新密钥。

Codex CLI 自带内置搜索（通过 --search 标志），但默认情况下是禁用的。所以为了防止搜索与 Kagi 冲突，只需不要启用它即可。

使用 Claude 设置

Claude Desktop

// claude_desktop_config.json
// 可以通过以下路径找到位置：
// 汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "您的 API 密钥",
        "KAGI_SUMMARIZER_ENGINE": "您的引擎选择" // 如果环境变量不存在，默认为 "cecil" 引擎
      }
    }
  }
}

Claude Code

使用以下命令添加 Kagi mcp 服务器（设置总结器引擎可选）：

claude mcp add kagi -e KAGI_API_KEY="您的 API 密钥" KAGI_SUMMARIZER_ENGINE="您的引擎选择" -- uvx kagimcp

现在，Claude Code 可以使用 Kagi mcp 服务器。然而，默认情况下，Claude Code 自带网络搜索功能，可能会与 Kagi 冲突。您可以在 Claude Code 设置文件（~/.claude/settings.json）中禁用 Claude 的网络搜索功能：

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

提出需要使用工具的问题

例如，对于搜索："谁是时代杂志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
# 或者
.venv/Scripts/activate # Windows

# 安装依赖项
uv sync

使用 Claude Desktop 设置

使用 MCP CLI SDK

# 如果尚未安装，请执行 `pip install mcp[cli]`
mcp install /绝对路径/到/父文件夹/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=您的 API 密钥"

手动设置

# claude_desktop_config.json
# 可以通过以下路径找到位置：
# 汉堡菜单 -> 文件 -> 设置 -> 开发者 -> 编辑配置
{
  "mcpServers": {
    "kagi": {
      "command": "uv",
      "args": [
        "--directory",
        "/绝对路径/到/父文件夹/kagimcp",
        "run",
        "kagimcp"
      ],
      "env": {
        "KAGI_API_KEY": "您的 API 密钥",
        "KAGI_SUMMARIZER_ENGINE": "您的引擎选择" // 如果环境变量不存在，默认为 "cecil" 引擎
      }
    }
  }
}

提出需要使用工具的问题

例如，对于搜索："谁是时代杂志2024年度人物？" 或者对于总结器："总结这个视频：https://www.youtube.com/watch?v=jNQXAC9IVRw"

调试

运行：

# 如果已安装 mcp cli (`pip install mcp[cli]`)
mcp dev /绝对路径/到/父文件夹/kagimcp/src/kagimcp/server.py

# 如果未安装
npx @modelcontextprotocol/inspector \
      uv \
      --directory /绝对路径/到/父文件夹/kagimcp \
      run \
      kagimcp

然后访问 MCP Inspector 在 http://localhost:5173。您可能需要在 inspector 的环境变量下添加您的 Kagi API 密钥，即 KAGI_API_KEY。

高级配置

  • 日志级别可通过 FASTMCP_LOG_LEVEL 环境变量调整（例如 FASTMCP_LOG_LEVEL="ERROR"）
  • 总结器引擎可以使用 KAGI_SUMMARIZER_ENGINE 环境变量自定义（例如 KAGI_SUMMARIZER_ENGINE="daphne"）
    • 了解不同的总结引擎 这里
  • 可以使用 --http 命令行选项切换流式 HTTP 传输。可以与 --port 和 --host 参数一起使用。

输出格式

直接输出翻译后的中文技术文档，保持完整的 Markdown 格式。