kagi-server MCP 服务器

用于 Kagi API 集成的 MCP 服务器

这是一个基于 TypeScript 的 MCP 服务器，集成了 Kagi 搜索 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 服务器：

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 将为你总结或分析搜索结果。

注意：计划中的工具（摘要、FastGPT、丰富）尚未实现，无法使用。

贡献

欢迎贡献！请随时提交 Pull Request。一些可以贡献的领域包括：

• 实现计划中的工具（摘要、FastGPT、丰富）
• 改进错误处理和输入验证
• 增强文档和使用示例

许可证

该项目采用 MIT 许可证。

路线图

• 实现 kagi_summarize 工具，用于网页和文本摘要
• 实现 kagi_fastgpt 工具，用于快速响应
• 实现 kagi_enrich 工具，用于获取丰富的新闻结果
• 改进错误处理并添加更强大的输入验证
• 添加更全面的使用示例和文档
• 将包发布到 npm，以便轻松安装并与 Claude Desktop 和 npx 一起使用