Kagi Search

Kagi MCP Server

Một máy chủ MCP được hỗ trợ bởi Kagi API. Nó cung cấp các công cụ tìm kiếm và trích xuất cho các máy khách tương thích MCP.

Công cụ

• kagi_search_fetch - tìm kiếm web, tin tức, video, podcast và hình ảnh với các tùy chọn trích xuất trang, bộ lọc và ống kính Kagi.
• kagi_extract - lấy nội dung đầy đủ của trang dưới dạng markdown.

Lưu ý: Các công cụ kagi_fastgpt và kagi_summarizer trước đây đã bị xóa. Cả hai dự kiến sẽ trở lại trong bản phát hành tương lai.

Máy chủ được lưu trữ

Chúng tôi chạy một máy chủ MCP được lưu trữ tại https://mcp.kagi.com/mcp — không cần cài đặt. Chỉ cần trỏ bất kỳ máy khách MCP hỗ trợ HTTP nào vào đó và xác thực bằng khóa API Kagi của bạn.

OAuth2 chưa được hỗ trợ (đang trong lộ trình của chúng tôi), vì vậy hiện tại hãy lấy khóa API từ bảng điều khiển và truyền nó qua xác thực HTTP Bearer.

Ví dụ với Claude Code:

claude mcp add kagi https://mcp.kagi.com/mcp --transport http --header "Authorization: Bearer $(read -sp 'API key: ' k; echo $k)" --scope user

Bạn muốn tự chạy? Xem Thiết lập Máy khách để cài đặt uvx cục bộ, hoặc Tự lưu trữ để lưu trữ máy chủ HTTP trên cơ sở hạ tầng của riêng bạn.

Yêu cầu

• Khóa API Kagi trong KAGI_API_KEY.
• uv cho đường dẫn cài đặt uvx được khuyến nghị.

Cài đặt uv:

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

Windows:

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

Thiết lập Máy khách

Codex CLI

codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcp

Codex ghi cấu hình MCP vào ~/.codex/config.toml.

Claude Desktop

Cài đặt uv trước.

MacOS/Linux:

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

Windows:

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

Sau đó trong cấu hình Claude Desktop của bạn (tìm thấy qua Cài đặt -> Nhà phát triển -> Chỉnh sửa Cấu hình):

{
  "mcpServers": {
    "kagi": {
      "command": "uvx",
      "args": ["kagimcp"],
      "env": {
        "KAGI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code

claude mcp add kagi -e KAGI_API_KEY="YOUR_API_KEY_HERE" -- uvx kagimcp

Smithery

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

Kiro

Thêm vào tệp cấu hình MCP Kiro của bạn (~/.kiro/settings/mcp.json cho toàn cục, hoặc .kiro/settings/mcp.json cho phạm vi dự án) sử dụng cùng JSON mcpServers như Claude Desktop. Xem tài liệu Kiro MCP để biết thêm chi tiết.

OpenCode

Chỉnh sửa tệp cấu hình OpenCode trong ~/.config/opencode/opencode.json và thêm nội dung sau:

{
  "mcp": {
    "kagi": {
      "type": "local",
      "command": ["uvx", "kagimcp"],
      "enabled": true,
      "environment": {
        "KAGI_API_KEY": "<YOUR_API_KEY_HERE>"
      }
    }
  }
}

Ví dụ Sử dụng

• Tìm kiếm: Who was Time's 2024 person of the year?
• Trích xuất: extract the full content of https://en.wikipedia.org/wiki/Model_Context_Protocol

Cấu hình

Biến môi trường	Mô tả
KAGI_API_KEY	Khóa API Kagi bắt buộc.
FASTMCP_LOG_LEVEL	Mức ghi nhật ký, ví dụ ERROR.
KAGI_SEARCH_TIMEOUT	Thời gian chờ tìm kiếm tính bằng giây. Mặc định là 10.
KAGI_EXTRACT_TIMEOUT	Thời gian chờ trích xuất tính bằng giây. Mặc định là 30.
KAGI_MAX_RETRIES	Số lần thử lại tối đa sau yêu cầu đầu tiên. Mặc định là 2; đặt 0 để tắt thử lại.
KAGI_HIDDEN_PARAMS	Các tham số tìm kiếm được phân tách bằng dấu phẩy để ẩn khỏi lược đồ hướng LLM.

Các tham số tìm kiếm có thể ẩn:

workflow, extract_count, limit, include_domains, exclude_domains, time_relative, after, before, file_type, lens_id

Ví dụ:

KAGI_HIDDEN_PARAMS="extract_count,after,before,time_relative,include_domains,exclude_domains"

Phát triển Cục bộ

git clone https://github.com/kagisearch/kagimcp.git
cd kagimcp
uv sync

Chạy cục bộ qua stdio:

KAGI_API_KEY=<YOUR_API_KEY_HERE> uv run kagimcp

Chạy với truyền tải HTTP có thể phát trực tuyến:

KAGI_API_KEY=<YOUR_API_KEY_HERE> uv run kagimcp --http --host 0.0.0.0 --port 8000

Tự lưu trữ

Chế độ HTTP là đa người dùng: mỗi yêu cầu cung cấp khóa API của nó qua tiêu đề Authorization: Bearer <key> thay vì biến môi trường toàn máy chủ, vì vậy một phiên bản có thể phục vụ nhiều người dùng. Kho lưu trữ đi kèm một Dockerfile cài đặt một kagimcp đã ghim từ PyPI và chạy nó ở chế độ HTTP. Container tôn trọng $PORT nên nó hoạt động trên bất kỳ nền tảng nào chèn một cổng (Railway, Render, Cloud Run, Fly.io, v.v.).

Xây dựng và chạy cục bộ:

docker build -t kagimcp-hosted .
docker run --rm -p 8000:8000 kagimcp-hosted

Kiểm tra nhanh:

curl -sL http://127.0.0.1:8000/mcp -X POST \
  -H "authorization: Bearer $KAGI_API_KEY" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Để nâng cấp phiên bản trong sản xuất, chỉnh sửa ghim trong Dockerfile và triển khai lại.

Gỡ lỗi

Kiểm tra gói đã xuất bản:

npx @modelcontextprotocol/inspector uvx kagimcp

Kiểm tra bản sao cục bộ:

npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/kagimcp run kagimcp

Trình kiểm tra thường có sẵn tại http://localhost:5173.

Hướng dẫn Bản dựng Trước

Nếu sử dụng bản dựng trước, các hướng dẫn cài đặt tương tự được áp dụng, nhưng sử dụng uvx --prerelease allow --from kagimcp==1.0.0rc2 kagimcp thay vì uvx kagimcp (thay thế 1.0.0rc2 bằng phiên bản bạn muốn cài đặt).