Kagi MCP server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates Kagi Search API capabilities, allowing web searches with customizable result limits to retrieve information from Kagi's search engine.

kagi-server MCP 服务器

用于 Kagi API 集成的 MCP 服务器

这是一个基于 TypeScript 的 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

环境设置

使用您的 Kagi API 密钥在根目录中创建一个.env文件:

KAGI_API_KEY=your_api_key_here

确保将.env添加到您的.gitignore文件中以确保您的 API 密钥安全。

安装

通过 Smithery 安装

要通过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 Inspector ,它以包脚本的形式提供:

npm run inspector

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

用法

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

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

注意:计划中的工具(summarize、fastgpt、enrich)尚未实现,无法使用。

贡献

欢迎贡献代码!请随时提交 Pull 请求。贡献代码的领域包括:

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

执照

该项目已获得 MIT 许可。

路线图

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Kagi 搜索 API 集成

  1. Features
    1. Implemented Tools
    2. Planned Tools (Not Yet Implemented)
  2. Development
    1. Environment Setup
      1. Installation
        1. Installing via Smithery
        2. Debugging
      2. Usage
        1. Contributing
          1. License
            1. Roadmap
              ID: z0f3dzmha4