Kagi MCP server

前提条件: 您需要有 Kagi 搜索 API 访问权限。目前处于封闭测试阶段，请通过 [email protected] 获取邀请。

快速安装

1. 安装 uv

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. 配置 Claude Desktop

编辑 claude_desktop_config.json (汉堡菜单 → 文件 → 设置 → 开发者 → 编辑配置):

{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "在此处输入您的API密钥"
      }
    }
  }
}

或通过 Smithery 一键安装

npx -y @smithery/cli install kagimcp --client claude

使用方法

向 Claude 提问需要搜索的内容，例如："2024年时代杂志年度人物是谁？"

调试

npx @modelcontextprotocol/inspector uvx kagimcp

开发环境设置

1. 克隆仓库

   git clone https://github.com/kagisearch/kagimcp.git
   

2. 安装依赖

   cd kagimcp
   uv venv
   source .venv/bin/activate  # MacOS/Linux
   # 或 .venv/Scripts/activate  # Windows
   uv sync
   

3. 配置 Claude Desktop

   使用 MCP CLI:

   # 安装 MCP CLI: pip install mcp[cli]
   mcp install /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py -v "KAGI_API_KEY=您的API密钥"
   

   或手动配置:

   {
     "mcpServers": {
       "kagi": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp",
           "run",
           "kagimcp"
         ],
         "env": {
           "KAGI_API_KEY": "您的API密钥"
         }
       }
     }
   }
   

4. 开发模式调试

   mcp dev /ABSOLUTE/PATH/TO/PARENT/FOLDER/kagimcp/src/kagimcp/server.py
   

注意事项

• 日志级别可通过 FASTMCP_LOG_LEVEL 环境变量调整，例如 FASTMCP_LOG_LEVEL="ERROR"