kagi-server MCP Server

kagi-server MCP 服务

用于集成 Kagi API 的 MCP 服务

这是一个基于 TypeScript 的 MCP 服务，用于集成 Kagi Search API。它通过提供以下功能展示 MCP 的核心概念：

• 使用 Kagi API 执行网页搜索和其他操作的工具（目前处于私有测试阶段）

功能

已实现的工具

• kagi_search - 使用 Kagi 执行网页搜索
  • 接受查询字符串和可选的结果数量上限作为参数
  • 返回 Kagi API 的搜索结果

计划中的工具（尚未实现）

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

开发

安装依赖项：

npm install

构建服务：

npm run build

进行开发并自动重新构建：

npm run watch

环境设置

在根目录中创建 .env 文件，并添加你的 Kagi API 密钥：

KAGI_API_KEY=your_api_key_here

请务必将 .env 添加到 .gitignore 文件中，以保护你的 API 密钥。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Kagi Server：

npx @smithery/cli install kagi-server --client claude

要与 Claude Desktop 配合使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

使用方法

服务启动并连接到 Claude Desktop 后，你就可以使用它执行网页搜索。例如：

1. 向 Claude 提问：“你能搜索一下量子计算领域的最新进展吗？”
2. Claude 会使用 kagi_search 工具从 Kagi API 获取结果。
3. Claude 随后会为你总结或分析搜索结果。

注意：计划中的工具（summarize、fastgpt、enrich）尚未实现，因此无法使用。

贡献

欢迎贡献！请随时提交 Pull Request。你可以通过以下方式参与贡献：

• 实现计划中的工具（summarize、fastgpt、enrich）
• 改进错误处理和输入验证
• 完善文档和使用示例

许可证

本项目采用 MIT 许可证。

路线图

• 实现 kagi_summarize 工具，用于网页和文本摘要
• 实现 kagi_fastgpt 工具，用于快速回复
• 实现 kagi_enrich 工具，用于获取增强版新闻结果
• 改进错误处理，并增强输入验证
• 添加更全面的使用示例和文档
• 将软件包发布到 npm，方便安装并与 Claude Desktop 和 npx 配合使用