kagi-server MCP 服务器

用于 Kagi API 集成的 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，集成了 Kagi 搜索 API。它通过提供以下功能来演示核心 MCP 概念：

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

功能

已实现的工具

• 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 一起使用