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 服务器
这是一个基于 TypeScript 的 MCP 服务器,集成了 Kagi Search API。它通过以下方式演示了 MCP 的核心概念:
- 使用 Kagi 的 API 执行网络搜索和其他操作的工具(目前处于私人测试阶段)
特征
已实施的工具
kagi_search
- 使用 Kagi 进行网络搜索- 采用查询字符串和可选限制作为参数
- 从 Kagi 的 API 返回搜索结果
计划中的工具(尚未实施)
kagi_summarize
- 生成网页或文本的摘要kagi_fastgpt
- 使用 Kagi 的 FastGPT 获得快速响应kagi_enrich
- 获取特定主题的丰富新闻结果
发展
安装依赖项:
构建服务器:
对于使用自动重建的开发:
环境设置
使用您的 Kagi API 密钥在根目录中创建一个.env
文件:
确保将.env
添加到您的.gitignore
文件中以确保您的 API 密钥安全。
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Kagi 服务器:
要与 Claude Desktop 一起使用,请添加服务器配置:
在 MacOS 上: ~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上: %APPDATA%/Claude/claude_desktop_config.json
调试
由于 MCP 服务器通过 stdio 进行通信,调试起来可能比较困难。我们推荐使用MCP Inspector ,它以包脚本的形式提供:
检查器将提供一个 URL 来访问浏览器中的调试工具。
用法
一旦服务器运行并连接到 Claude Desktop,您就可以使用它进行网页搜索。例如:
- 问克劳德:“你能搜索有关量子计算最新进展的信息吗?”
- Claude 将使用
kagi_search
工具从 Kagi 的 API 中获取结果。 - 然后,Claude 将为您总结或分析搜索结果。
注意:计划中的工具(summarize、fastgpt、enrich)尚未实现,无法使用。
贡献
欢迎贡献代码!请随时提交 Pull 请求。贡献代码的领域包括:
- 实施计划中的工具(总结、fastgpt、丰富)
- 改进错误处理和输入验证
- 增强文档和使用示例
执照
该项目已获得 MIT 许可。
路线图
- 实现
kagi_summarize
工具用于网页和文本摘要 - 实施
kagi_fastgpt
工具以实现快速响应 - 实现
kagi_enrich
工具来获取丰富的新闻结果 - 改进错误处理并添加更强大的输入验证
- 添加更全面的使用示例和文档
- 将软件包发布到 npm,以便轻松安装并使用 Claude Desktop 和 npx