kagi-server MCP 服务器

Kagi API集成的MCP服务器

这是一个基于TypeScript的MCP服务器，用于集成Kagi搜索API。它通过提供以下功能展示了核心MCP概念：

• 使用Kagi API进行网络搜索和其他操作的工具（目前处于私有测试阶段）

功能

已实现的工具

• kagi_search - 使用Kagi进行网络搜索
  • 接收查询字符串和可选的limit作为参数
  • 返回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安装Claude桌面版的Kagi服务器：

npx @smithery/cli install kagi-server --client claude

要使用Claude桌面版，请添加服务器配置：

在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服务器通过stdio通信，调试可能具有挑战性。我们建议使用MCP Inspector，它作为包脚本提供：

npm run inspector

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

使用

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

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

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

贡献

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

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

许可证

本项目根据MIT许可证授权。

路线图

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