JinDaGe - mcp-servers-kagi MCP Details

article

README

🚀 Kagi 服务器 MCP 服务器

Kagi API 集成的 MCP 服务器，这是一个基于 TypeScript 的 MCP 服务器，集成了 Kagi 搜索 API。它通过实现核心 MCP 概念来展示功能，可作为使用 Kagi 进行网络搜索和其他操作的工具，为用户提供便捷的搜索体验。

🚀 快速开始

本项目是一个集成 Kagi 搜索 API 的 MCP 服务器，通过实现核心 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 文件中以保持安全。

通过 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，您就可以使用它进行网络搜索。例如：

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

⚠️ 重要提示

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

🤝 贡献

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

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

📄 许可证

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

🗺️ 路线图

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

mcp-servers-kagi