Kagi MCP服务器

弃用通知⚠

此存储库不再维护。如果你想要一个MCP服务器 kagi-cli，使用内置 kagi mcp 命令代替。请参阅以下文档 https://kagi.micr.dev/commands/mcp.

kagi mcp

kagi-mcp 是一个基于 kagi-cli.

它故意只是一个额外的回购：

• 单独回购
• 一个Rust二进制文件
• 包裹 kagi CLI而不是重新实现Kagi逻辑
• 对于结构化工具结果，默认返回TOON
• 保持 format=json 在支持CLI格式选择的工具上可用

kagi-cli v0.5.0还附带了本机 kagi mcp 命令。当你只需要最少的内置工具时，可以使用它。当您希望将更广泛的CLI界面暴露给代理时，可以使用此存储库，包括助手、提取、新闻、翻译、丰富、帐户设置、本地历史记录、本地站点首选项、监视和通知工作流。

需求

• kagi-cli v0.8.1或更新版本
• A工作 kagi 二进制开启 PATH，或 KAGI_CLI_PATH 指向它
• 通过环境变量提供的Kagi凭据
  • KAGI_SESSION_TOKEN -用户功能（搜索、快速、助手、翻译）
  • KAGI_API_KEY -对于当前 /api/v1 付费API功能（搜索、提取）
  • KAGI_API_TOKEN -为了遗产 /api/v0 付费API功能（summary、fastgpt、rich）

集 KAGI_CLI_PROFILE 当您希望每个包装好的CLI调用都使用一个命名 .kagi.toml 轮廓。环境变量仍然是建议的MCP身份验证路径，因为它们在MCP服务器配置中是显式的，不依赖于服务器进程工作目录。

kagi-mcp 将所有Kagi请求委托给已配置的 kagi 二元的。V1 API路径，包括付费的API搜索/提取 KAGI_API_KEY 当前的搜索过滤器来自 kagi-cli v0.8.1+。

构建

cargo build --release

跑

KAGI_CLI_PATH=/path/to/kagi \
KAGI_SESSION_TOKEN=... \
KAGI_API_KEY=... \
KAGI_API_TOKEN=... \
./target/release/kagi-mcp

可选环境变量：

克劳德桌面

{
  "mcpServers": {
    "kagi": {
      "command": "/path/to/kagi-mcp/target/release/kagi-mcp",
      "env": {
        "KAGI_CLI_PATH": "/path/to/kagi",
        "KAGI_SESSION_TOKEN": "your-session-token",
        "KAGI_API_KEY": "your-api-key",
        "KAGI_API_TOKEN": "your-api-token"
      }
    }
  }
}

工具

搜索

快速回答

助手

翻译

总结

提取

新闻

富集

其他

账户设置

范围边界

kagi_watch 已公开奇偶校验，但如果满足以下条件，它可以运行到配置的子进程超时 count 省略或设置为 0.更喜欢有限 count 用于MCP呼叫。 kagi_assistant_repl 以有界REPL包装器的形式公开：pass prompts，服务器将这些提示提供给 kagi assistant repl 紧随其后 /exit. kagi_notify 账户设置突变工具是副作用；仅当webhook或帐户突变是故意的时才调用它们。

包装好的CLI kagi mcp 子命令未作为工具公开，因为此二进制文件已经是MCP服务器。在一个工具调用中生成另一个stdio MCP服务器不会产生正常的请求/响应结果。

身份验证模型

建筑

MCP Client (Claude, Zed, etc.)
       | stdio
       v
+-----------------+     spawn      +-----------+
|   kagi-mcp      |--------------->|  kagi CLI |
|   rmcp + tokio  |                |           |
+-----------------+                +-----------+

服务器是一个生成的Rust二进制文件 kagi 每个工具调用的CLI子流程。默认情况下，解析结构化JSON输出并将其转换为TOON；显式文本输出按原样传递。

错误处理： CLI子进程失败、非零退出、超时和无效JSON作为MCP错误结果返回。超时可通过以下方式配置 KAGI_MCP_TIMEOUT_MS.

测试

cargo test
cargo clippy --all-targets --all-features -- -D warnings

测试套件使用夹具脚本作为本地脚本 kagi 二进制文件，用于验证参数构建、JSON解析、TOON转换、stdin处理、配置文件传递和错误显示，而不需要真正的Kagi连接。

许可证

麻省理工学院