kagi-server MCP Server

用于集成 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 自动安装 Kagi Server 到 Claude Desktop：

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 服务器通过标准 I/O 通信，调试可能会有挑战。我们推荐使用 MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector 将提供一个 URL，以便在浏览器中访问调试工具。

使用

一旦服务器运行并连接到 Claude Desktop，你可以使用它执行网络搜索。例如：

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

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

贡献

欢迎贡献！请随意提交拉取请求。可以贡献的领域包括：

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

许可证

本项目采用 MIT 许可证。

发展路线图

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