kagi-ken-mcp

围绕kagi-ken包构建的一个轻量级Node MCP服务器，使用Kagi会话令牌访问Kagi.com服务：

• 搜索：搜索Kagi
• 摘要生成器：使用Kagi的摘要生成器从URL或文本内容创建摘要

与需要API访问的官方Kagi API不同，这个MCP服务器使用您现有的Kagi会话来访问搜索和摘要生成功能。

"Kagi-ken" 是“Kagi”（服务）和“令牌”的合成词。

为什么？

Kagi API 需要一个单独的API密钥，目前这些密钥是邀请制的。如果您已经拥有Kagi订阅但没有API访问权限，但仍想通过LLMs或像Claude这样的代理程序编程地访问Kagi的服务，那么这个MCP服务器提供了一个替代方案。

功能

• 搜索：使用Kagi搜索获取网络结果，并支持并发查询处理
• 摘要生成：从URL中总结内容，支持自定义输出类型和语言

该服务器支持两种使用您的Kagi会话令牌的方法（参见安装），按以下顺序：

1. KAGI_SESSION_TOKEN 环境变量
2. 包含令牌字符串的 ~/.kagi_session_token 文件

它包括全面的错误处理：

• 连接超时（每个搜索10秒）
• 输入验证
• 环境变量验证
• 友好的错误格式化

<a href="https://glama.ai/mcp/servers/@czottmann/kagi-ken-mcp"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=3451666709,2526689066&fm=3081&app=3081&f=PNG?w=760&h=200" alt="kagi-kan-mcp MCP服务器" /> </a>

安装

需要Node.js 22+。

1. 获取Kagi会话令牌

1. 在浏览器中访问Kagi设置
2. 复制会话链接
3. 从链接中提取token值
4. 使用该值作为您的会话令牌：保存到~/.kagi_session_token（推荐），或者作为KAGI_SESSION_TOKEN环境变量传递

服务器将首先自动尝试环境变量，如果失败则回退到令牌文件。

[!WARNING] 安全提示：请保护好您的会话令牌。它提供了对您的Kagi账户的访问权限。

2.a. 将MCP服务器添加到Claude Desktop

将kagi-ken-mcp添加到您的claude_desktop_config.json，您可以通过Claude Desktop应用程序中的设置→开发者→本地MCP服务器→编辑配置打开此文件。

选项1：使用令牌文件（推荐）

{
  "mcpServers": {
    "kagi-ken-mcp": {
      "command": "npx",
      "args": ["-y", "github:czottmann/kagi-ken-mcp"]
    }
  }
}

选项2：使用环境变量

{
  "mcpServers": {
    "kagi-ken-mcp": {
      "command": "npx",
      "args": ["-y", "github:czottmann/kagi-ken-mcp"],
      "env": {
        "KAGI_SESSION_TOKEN": "YOUR_SESSION_TOKEN_HERE"
      }
    }
  }
}

安装后

禁用Claude Desktop内置的网络搜索，以便使用这里的MCP服务器。并且可能将其添加到您的“个人偏好设置”（即系统提示）中，在设置中：

对于网络搜索，请使用kagi-ken-mcp MCP服务器的`kagi_search_fetch`工具。
对于URL摘要，请使用kagi-ken-mcp MCP服务器的`kagi_summarizer`工具。

2.b. 将MCP服务器添加到Claude Code

选项1：使用令牌文件（推荐）

claude mcp add kagi-ken-mcp --scope user -- npx -y github:czottmann/kagi-ken-mcp

选项2：使用环境变量

claude mcp add kagi-ken-mcp \
  --scope user \
  --env KAGI_SESSION_TOKEN="YOUR_SESSION_TOKEN_HERE" -- \
  npx -y github:czottmann/kagi-ken-mcp

安装后

可选地禁用Claude Code内置的网络搜索，通过在相关的.claude/settings*.json文件中设置权限：

{
  "permissions": {
    "deny": [
      "WebSearch"
    ],
    "allow": [
      "mcp__kagi-ken-mcp__kagi_search_fetch",
      "mcp__kagi-ken-mcp__kagi_summarizer"
    ]
  }
}

使用方法：提出需要使用工具的问题

例如，搜索问题可以是：“谁是《时代》杂志2024年度人物？”；摘要生成问题可以是：“总结这个视频：https://www.youtube.com/watch?v=sczwaYyaevY”。

工具

kagi_search_fetch

基于一个或多个查询使用Kagi搜索API获取网络结果。结果连续编号，便于引用。

参数：

• queries（字符串数组）：一个或多个搜索查询

kagi_summarizer

使用Kagi摘要生成器API从URL中总结内容。支持多种文档类型，包括网页、视频和音频。

参数：

• url（字符串）：要总结的URL
• summary_type（枚举）："summary"用于段落式摘要或"takeaway"用于要点摘要（默认："summary"）
• target_language（字符串，可选）：语言代码（例如："EN"表示英语，默认："EN"）

开发

项目结构

kagi-ken-mcp/
├── src/
│   ├── index.js              # 主服务器入口点
│   ├── tools/
│   │   ├── search.js         # 搜索工具实现
│   │   └── summarizer.js     # 摘要生成器工具实现
│   └── utils/
│       └── formatting.js     # 工具函数
├── package.json
└── README.md

安装

1. 克隆仓库：

   git clone <repository-url>
   cd kagi-ken-mcp
   

2. 安装依赖：

   npm install
   

开发模式运行

npm run dev

调试

使用MCP Inspector进行调试：

npx @modelcontextprotocol/inspector node ./src/index.js

然后在http://localhost:5173访问检查器。如果使用环境变量，请在检查器的环境变量部分添加您的KAGI_SESSION_TOKEN。

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 使用MCP Inspector测试
5. 提交拉取请求

作者

Carlo Zottmann, carlo@zottmann.dev, https://c.zottmann.dev, https://github.com/czottmann。

本项目既不隶属于也不由Kagi认可。我只是非常满意的客户。

[!TIP] 我制作了与Shortcuts相关的macOS和iOS生产力应用，如Actions For Obsidian、Browser Actions（为几个主要浏览器增加了Shortcuts支持）和BarCuts（一个非常有用的上下文Shortcuts启动器）。请查看它们！

相关项目

• czottmann/kagi-ken - 基于会话令牌的非官方Kagi客户端，Node
• czottmann/kagi-ken-cli - 基于会话令牌的非官方Node CLI工具，Node
• 官方Kagi MCP服务器 - Python
• 模型上下文协议