mcp-servers-kagi

mcp-servers-kagi 是一个 Model Context Protocol (MCP) 服务器实现，用于将 Kagi 的 API 集成到 MCP 生态中。该项目由 ac3xx 开发，托管于 GitHub，采用 TypeScript 编写，旨在演示 MCP 核心概念并提供实际的搜索功能。

一、用途 该服务器的主要用途是作为 MCP 服务器，连接 AI 客户端（如 Claude Desktop）与 Kagi 搜索 API。通过 MCP 协议，AI 助手可以调用服务器提供的工具，执行网络搜索等操作，从而增强其获取实时信息的能力。

二、主要能力 目前，服务器已实现一个工具：

• kagi_search：使用 Kagi 执行网络搜索。接受一个查询字符串和一个可选的结果数量限制（limit）作为参数，返回来自 Kagi API 的搜索结果。

此外，项目计划但尚未实现以下工具（当前不可用）：

• kagi_summarize：生成网页或文本的摘要。
• kagi_fastgpt：使用 Kagi 的 FastGPT 获取快速响应。
• kagi_enrich：获取特定主题的增强新闻结果。

三、使用方式

1. 环境准备：需要 Node.js 环境，安装依赖并构建服务器。项目提供了构建和开发模式（自动重建）的命令，具体命令需参考仓库说明。
2. 环境配置：在根目录创建 .env 文件，填入 Kagi API 密钥。注意将 .env 加入 .gitignore 以保证安全。
3. 通过 Smithery 安装：可以使用 Smithery 自动为 Claude Desktop 安装 Kagi Server。
4. 配置 Claude Desktop：在 Claude Desktop 的配置文件中添加服务器配置。配置文件位置：macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%/Claude/claude_desktop_config.json。
5. 调试：由于 MCP 服务器通过 stdio 通信，调试可能较困难。建议使用 MCP Inspector，可通过包脚本启动，它将提供一个 URL 以在浏览器中访问调试工具。
6. 使用示例：服务器运行并连接至 Claude Desktop 后，可以要求 Claude 执行搜索，例如：“Can you search for information about the latest advancements in quantum computing?” Claude 将调用 kagi_search 工具获取结果，然后进行总结或分析。

四、适用场景 适用于希望为 AI 助手（尤其是 Claude Desktop）增加 Kagi 网络搜索能力的用户。Kagi 目前处于私有测试阶段，因此需要有效的 Kagi API 密钥。适合开发者、技术爱好者或需要集成搜索功能到 MCP 生态的场合。

五、限制

• Kagi API 目前处于私有测试阶段，可能限制访问。
• 计划中的三个工具（摘要、FastGPT、富新闻）尚未实现，无法使用。
• 项目依赖于 Kagi API 密钥，需要用户自行获取。
• 服务器通过 stdio 通信，调试需要额外工具。

六、贡献与许可证 项目欢迎贡献，包括实现计划中的工具、改进错误处理和输入验证、增强文档和示例、发布到 npm 等。项目采用 MIT 许可证。