🚀 Kagi 服务器 MCP 服务器

Kagi 服务器 MCP 服务器是一个集成了 Kagi API 的 MCP 服务器。它基于 TypeScript 构建，通过实现核心 MCP 概念，可使用 Kagi 进行网络搜索等操作，为用户提供便捷的搜索服务。

🚀 快速开始

Kagi 服务器 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

通过 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"
      }
    }
  }
}

💻 使用示例

基础用法

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

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

⚠️ 重要提示

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

🔧 技术细节

这是一个基于 TypeScript 的 MCP 服务器，集成了 Kagi 搜索 API。它通过实现核心 MCP 概念来展示功能，使用 Kagi 作为进行网络搜索和其他操作的工具，提供查询字符串和可选限制参数，并返回 Kagi API 的搜索结果。

📄 许可证

该项目在 MIT 许可证下发布。

📚 详细文档

环境配置

在项目根目录创建一个 .env 文件，包含您的 Kagi API 密钥：

KAGI_API_KEY=your_api_key_here

请确保将 .env 添加到 .gitignore 文件中以保持安全。

调试

由于 MCP 服务器通过标准输入/输出进行通信，调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供访问浏览器调试工具的 URL。

贡献

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

• 实现计划中的工具（摘要、fastgpt、enrich）。
• 改善错误处理和输入验证。
• 提高文档的质量和示例。

路线图

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