kagimcp  by kagisearch

AI tool integration server for Kagi search and summarization

Created 1 year ago
259 stars

Top 97.9% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

This project provides the official Model Context Protocol (MCP) server for Kagi Search, enabling integration with AI tools. It allows users to leverage Kagi's search and summarization capabilities within LLM-powered applications.

How It Works

The kagimcp project implements the Model Context Protocol to expose Kagi's search API and summarization models as a server for AI tools like Claude and Codex CLI. It utilizes the uv package manager for dependencies and uvx for command execution, simplifying setup and ensuring consistent environments. This MCP architecture promotes interoperability.

Quick Start & Requirements

  • Primary Install/Run: Install uv (via provided script), then run uvx kagimcp. Alternatively, use npx -y @smithery/cli install kagimcp --client claude.
  • Prerequisites: Mandatory Kagi Search API access (closed beta, request via support@kagi.com) and an API key (KAGI_API_KEY).
  • Setup Examples:
    • Codex CLI: codex mcp add kagi --env KAGI_API_KEY=<YOUR_API_KEY_HERE> -- uvx kagimcp
    • Claude Desktop/Code: Requires configuration in claude_desktop_config.json or via claude mcp add command, specifying KAGI_API_KEY and optionally KAGI_SUMMARIZER_ENGINE. Claude's native web search may need disabling.
  • Local/Dev Setup: Clone repo, install uv, create uv venv, uv sync. Debugging via mcp dev or npx @modelcontextprotocol/inspector.
  • Links: Kagi Support for API invite: support@kagi.com.

Highlighted Details

  • Official MCP server for Kagi Search, enabling its use in LLM applications.
  • Supports integration with tools like OpenAI Codex CLI and Anthropic's Claude.
  • Configurable summarization engine via KAGI_SUMMARIZER_ENGINE environment variable (e.g., "cecil", "daphne").
  • Adjustable logging level via FASTMCP_LOG_LEVEL environment variable.
  • Optional streamable HTTP transport (--http) with configurable host/port.

Maintenance & Community

  • A relevant issue is linked: https://github.com/kagisearch/kagimcp/issues/4.
  • No explicit details on maintainers, community channels (Discord/Slack), or roadmap are provided in the README.

Licensing & Compatibility

  • The license type is not specified in the provided README content. This requires further investigation for commercial use or integration compatibility.

Limitations & Caveats

  • Access to the Kagi Search API is currently restricted to a closed beta, requiring manual request.
  • Potential conflicts with default web search functionality in integrated tools must be managed, often by disabling the tool's native search.
  • Setup relies on specific tooling (uv, codex, claude), which may add to the initial learning curve.
Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
21 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.