Kagi搜索API集成服务

一个基于TypeScript的MCP服务器,用于集成Kagi搜索API,提供网页搜索等功能。

  • by ac3xx
  • TypeScript
  • 本地部署
  • 37 星标
  • 更新于
在 GitHub 查看 ac3xx/mcp-servers-kagi

使用说明

kagi服务器MCP服务器

用于Kagi API集成的MCP服务器

这是一个基于类型脚本的MCP服务器,集成了Kagi Search API。它通过提供以下内容展示了MCP的核心概念:

  • 使用Kagi的API执行网络搜索和其他操作的工具(目前处于私人测试版)

特性

已实施的工具

  • 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安装

通过以下方式自动安装Claude Desktop的Kagi服务器 史密瑟里:

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服务器通过stdio进行通信,调试可能具有挑战性。我们建议使用 MCP检查员,可作为包脚本使用:

npm run inspector

检查器将提供一个URL,用于访问浏览器中的调试工具。

用法

一旦服务器运行并连接到Claude Desktop,您就可以使用它来执行网络搜索。例如:

  1. 问克劳德:“你能搜索有关量子计算最新进展的信息吗?”
  2. 克劳德将使用 kagi_search 从Kagi的API获取结果的工具。
  3. 然后,Claude将为您总结或分析搜索结果。

注意:计划中的工具(summary、fastgpt、richest)尚未实施,无法使用。

贡献

欢迎投稿!请随时提交拉取请求。一些贡献领域包括:

  • 实施计划工具(总结、快速gpt、丰富)
  • 改进错误处理和输入验证
  • 增强文档和使用示例

许可证

该项目根据MIT许可证获得许可。

路线图

  • 实施 kagi_summarize 网页和文本摘要工具
  • 实施 kagi_fastgpt 快速响应工具
  • 实施 kagi_enrich 获取丰富新闻结果的工具
  • 改进错误处理并添加更强大的输入验证
  • 添加更全面的使用示例和文档
  • 将包发布到npm,便于安装和使用Claude Desktop和npx