Ac3xx_mcp Servers Kagi

Ac3xx_mcp Servers Kagi

🚀 Kagi-server MCP 服务器

Kagi-server MCP 服务器是一个集成了 Kagi API 的 MCP 服务器,基于 TypeScript 构建。它借助 Kagi 搜索 API,为用户提供网络搜索等功能,目前处于私人内测阶段。

smithery badge

🚀 快速开始

Kagi-server MCP 服务器是一个集成 Kagi 搜索 API 的 MCP 服务器,它基于 TypeScript 构建,可作为使用 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 使用
  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-23 12:12

相似服务问题