Kagi-server MCP 服务器

Kagi API 集成的 MCP 服务器

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

• 使用 Kagi 进行网络搜索和其他操作的工具
  • 目前处于私人内测阶段

特性

已实现的工具

• 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 for 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 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将会提供一个访问调试工具的 URL，在您的浏览器中打开。

使用

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

1. 询问 Claude："你能查找关于量子计算最新进展的信息吗？"
2. Claude 将使用 kagi_search 工具从 Kagi 的 API 获取结果。
3. Claude 然后会总结或分析搜索结果为您提供信息。

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

贡献

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

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

许可证

此项目根据 MIT License 许可。

未来规划

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