使用说明
项目简介
Kagi Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在为大型语言模型 (LLM) 客户端提供网页搜索能力。它通过集成 Kagi 搜索 API,使得 LLM 能够调用 'kagi_search' 工具来执行网页搜索并获取信息。
主要功能点
- 网页搜索工具 (kagi_search): 允许 LLM 客户端通过 Kagi 搜索 API 执行网页搜索。该工具接受查询字符串和可选的结果数量限制作为参数,并返回搜索结果。
安装步骤
- 安装依赖: 在项目根目录下运行 'npm install' 命令安装项目依赖。
- 构建服务器: 运行 'npm run build' 命令编译 TypeScript 代码,生成可执行的 JavaScript 文件。
- 配置环境变量: 在项目根目录下创建 '.env' 文件,并添加您的 Kagi API 密钥:
请将 'your_api_key_here' 替换为您的实际 Kagi API 密钥。KAGI_API_KEY=your_api_key_here
服务器配置
要将 Kagi Server 与 MCP 客户端(例如 Claude Desktop)配合使用,您需要配置客户端以连接到该服务器。以下是 Claude Desktop 的配置示例,您需要将配置添加到 'claude_desktop_config.json' 文件中(文件路径请参考仓库 README):
{ "mcpServers": { "kagi-server": { "command": "/path/to/kagi-server/build/index.js", "env": { "KAGI_API_KEY": "your_api_key_here" } } } }
- 'server name': 'kagi-server' (服务器名称,客户端据此名称引用该服务器)
- 'command': '/path/to/kagi-server/build/index.js' (服务器启动命令。请根据您的实际项目路径,填写 'build/index.js' 文件的绝对路径或相对路径)
- 'env': 'KAGI_API_KEY': 'your_api_key_here' (环境变量配置,这里配置了 Kagi API 密钥,请替换为您的实际密钥)
基本使用方法
- 启动服务器: 配置完成后,当 MCP 客户端启动时,Kagi Server 将会自动启动并与客户端建立连接(通过 stdio)。
- 使用搜索工具: 在与 LLM 客户端的对话中,当您提出需要网页搜索的问题时,客户端将能够调用 'kagi_search' 工具来执行搜索。例如,您可以向 Claude 提问:“搜索关于量子计算最新进展的信息”。Claude 将使用 'kagi_search' 工具获取 Kagi API 的搜索结果,并基于结果给出回答。
请注意: 目前该服务器仅实现了 'kagi_search' 工具,其他计划中的工具(如 'kagi_summarize', 'kagi_fastgpt', 'kagi_enrich')尚未实现。
信息
分类
网页与API