用途
kagi-ken-mcp 是一个轻量的 Node MCP 服务器，封装了 kagi-ken 包，用于在没有 Kagi API 访问权限的前提下使用 Kagi.com 的服务。官方 Kagi API 需要单独的 API 密钥，且目前仅限邀请；如果你已有 Kagi 订阅但尚无 API 访问权限，又希望让 Claude 等 LLM 或智能体以编程方式调用 Kagi 服务，此 MCP 服务器提供了一种替代方案。项目名 "Kagi-ken" 是 "Kagi"（服务名）与 "token" 的合成词。作者声明该项目与 Kagi 无关联，也未获其背书。
主要能力
- 搜索（Search）：使用 Kagi Search 获取网页结果，支持并发查询处理。
- 摘要（Summarizer）：使用 Kagi 的 Summarizer 从 URL 生成摘要，支持网页、视频、音频等多种文档类型。
与需要 API 访问权限的官方 Kagi API 不同，此 MCP 服务器使用你现有的 Kagi 会话访问搜索与摘要功能。
使用方式
认证
服务器支持两种使用 Kagi 会话令牌的方法，按以下顺序尝试：
KAGI_SESSION_TOKEN环境变量；- 包含令牌字符串的
~/.kagi_session_token文件。
获取会话令牌的步骤：
- 在浏览器中访问 Kagi 设置页；
- 复制 Session Link；
- 从链接中提取 token 值；
- 将该值作为会话令牌使用：保存到
~/.kagi_session_token（推荐），或作为KAGI_SESSION_TOKEN环境变量传入。
安全提示：请妥善保管会话令牌，它可访问你的 Kagi 账户。
环境要求
需要 Node.js 22 及以上版本。
添加到 Claude Desktop
将 kagi-ken-mcp 添加到 claude_desktop_config.json，可在 Claude Desktop 应用中通过 Settings → Developer → Local MCP Servers → Edit Config 打开该配置。建议关闭 Claude Desktop 内置的网页搜索，使其改用此 MCP 服务器；并可在 Settings 的 “Personal preferences”（即系统提示词）中添加相关说明。
添加到 Claude Code
可通过在相关的 .claude/settings*.json 文件中设置权限来禁用 Claude Code 内置的网页搜索（可选）。
使用示例
发起需要调用工具的查询，例如：搜索类 “Who was time's 2024 person of the year?”，摘要类 “summarize this video: https://www.youtube.com/watch?v=sczwaYyaevY”。
工具说明
kagi_search_fetch：基于一个或多个查询获取网页结果。结果连续编号，便于引用。参数：queries（字符串数组）：一个或多个搜索查询。kagi_summarizer：使用 Kagi Summarizer API 对 URL 内容生成摘要，支持网页、视频、音频等多种文档类型。参数：url（字符串）：要摘要的 URL；summary_type（枚举）："summary"为段落式散文，"takeaway"为要点列表（默认"summary"）；target_language（字符串，可选）：语言代码，如"EN"表示英语（默认"EN"）。
错误处理
服务器包含较完善的错误处理：连接超时（每次搜索 10 秒）、无效输入校验、环境变量校验、优雅的错误格式化。
项目结构与开发
克隆仓库：git clone <repository-url> 后 cd kagi-ken-mcp；安装依赖：npm install。
开发模式下可使用 MCP Inspector 调试，随后访问 http://localhost:5173。若使用环境变量，请在 inspector 的环境变量区域添加你的 KAGI_SESSION_TOKEN。
贡献流程：Fork 仓库、创建特性分支、进行修改、使用 MCP Inspector 测试、提交 pull request。
适用场景
适用于已订阅 Kagi、但没有（或尚未获得）官方 API 访问权限，希望让 LLM 或智能体（如 Claude）以编程方式调用 Kagi 搜索与摘要能力的用户。
限制
- 需要是 Kagi 付费客户（订阅用户）。
- 为非官方项目，与 Kagi 无关联或背书。
- 依赖会话令牌认证，需妥善保管令牌。
- 需要 Node.js 22 及以上版本。
- 关于具体的定价、平台兼容范围、性能效果等更多细节，资料暂未提供。
