kagimcp 是 Kagi Search 及其他工具的官方 Model Context Protocol(MCP)服务器,代码仓库位于 https://github.com/kagisearch/kagimcp。它由 Kagi API 提供后端支持,向兼容 MCP 的客户端开放搜索和内容提取工具。
主要能力
kagimcp 目前暴露两个工具:
- kagi_search_fetch:支持网页、新闻、视频、播客和图片搜索,可选页面摘要(extracts)、过滤器和 Kagi lenses。
- kagi_extract:将网页的完整内容抓取为 Markdown。
注意:此前的 kagi_fastgpt 和 kagi_summarizer 工具已被移除,二者计划在未来的版本中回归。
使用方式
官方提供托管的 MCP 服务器,地址为 https://mcp.kagi.com/mcp,无需安装,任何支持 HTTP 的 MCP 客户端都可以指向该地址,并使用自己的 Kagi API 密钥进行认证。目前尚不支持 OAuth2(已在路线图中),因此需要从仪表盘获取 API 密钥,并通过 Bearer HTTP 认证方式传入。文档中给出了 Claude Code 的示例。
如果希望自行运行,可以选择本地 uvx 安装(参见 Client Setup),或自行托管 HTTP 服务器(参见 Self-Hosting)。
前置条件:
- Kagi API 密钥,放在 KAGI_API_KEY 环境变量中。
- uv,推荐 uvx 安装路径需要它。
客户端接入方面,文档列出了 Codex(MCP 配置写入 ~/.codex/config.toml)、Claude Desktop(通过 Settings -> Developer -> Edit Config 找到配置)、Kiro(全局配置 ~/.kiro/settings/mcp.json,或项目级 .kiro/settings/mcp.json,使用与 Claude Desktop 相同的 mcpServers JSON)、OpenCode(编辑 ~/.config/opencode/opencode.json)等客户端的配置说明。
使用示例:
- 搜索:Who was Time's 2024 person of the year?
- 提取:extract the full content of https://en.wikipedia.org/wiki/Model_Context_Protocol
本地与自托管
可以本地通过 stdio 运行,或使用 streamable HTTP 传输方式运行。HTTP 模式为多租户:每个请求通过 Authorization: Bearer <key> 头提供 API 密钥,而不是使用服务器级环境变量,因此一个实例可以服务多个用户。仓库附带 Dockerfile,会安装来自 PyPI 的、固定版本的 kagimcp,并以 HTTP 模式运行。容器遵循 $PORT,因此可用于任何会注入该变量的平台(Railway、Render、Cloud Run、Fly.io 等)。
生产环境升级版本时,修改 Dockerfile 中的版本固定值并重新部署。
调试与预发布
可以使用 inspector 检查已发布的包或本地检出,inspector 通常位于 http://localhost:5173。
如果使用预发布构建,安装说明相同,但需将 uvx kagimcp 替换为 uvx --prerelease allow --from kagimcp==1.0.0rc2 kagimcp(其中 1.0.0rc2 替换为要安装的版本)。
适用场景与限制
kagimcp 适用于需要在 MCP 兼容客户端中获得 Kagi 搜索与网页内容提取能力的场景,例如让 AI 助手进行联网搜索或抓取页面正文。限制方面:需要有效的 Kagi API 密钥;目前不支持 OAuth2;kagi_fastgpt 与 kagi_summarizer 工具当前不可用;其他具体配额、收费或平台支持细节官方文本暂未提供。