Kagimcp Go

🚀 Kagi MCP Server

An MCP (Model Context Protocol) server integrating Kagi's search and summarization APIs. This server enables LLMs (Large Language Models) to leverage Kagi's high - quality search and AI capabilities to search the web and summarize web pages.

🚀 Quick Start

The Kagi MCP Server is a powerful tool that allows LLMs to use Kagi's search and summarization features. Before you start, make sure you meet the prerequisites and follow the installation steps.

✨ Features

• 🔍 Kagi Search: Search the web using Kagi's privacy - preserving search engine.
• 📝 Kagi Summarizer: Summarize web pages using Kagi's FastGPT summarization API.
• 🔄 Multiple Transport Protocols: Support for standard input/output (stdio) and Server - Sent Events (SSE).
• 🔑 API Key Management: Flexible configuration options for Kagi API keys.

📦 Installation

Prerequisites

• Go 1.18+ (for building from source).
• A Kagi API key (available to Kagi subscribers).

Using Go

# Clone the repository
git clone https://github.com/mgomes/kagimcp.git
cd kagimcp

# Download dependencies
go mod download

# Build the application
go build -o kagimcp

💻 Usage Examples

Command - line Options

Usage: ./kagimcp
  -api-key string       Kagi API key (can also be set via the environment variable KAGI_API_KEY)
  -port string          SSE server port (default "8080")
  -t string             Transport protocol type (stdio or sse, default "stdio")

Running in stdio Mode

This mode is suitable for direct integration with LLM platforms that support subprocess communication.

# Run directly using the binary
KAGI_API_KEY=your_api_key ./kagimcp -t stdio

Running in SSE Mode

This mode starts an HTTP server using Server - Sent Events (SSE) for communication.

# Run directly using the binary
KAGI_API_KEY=your_api_key ./kagimcp -t sse -port 8080

Available Tools

Kagi Search

Search the web using Kagi's search API.

Parameters:

• query (string, required): The search query string.
• limit (number, optional): The maximum number of results (1 - 10, default: 5).

Example:

{
  "name": "kagi_search",
  "arguments": {
    "query": "Climate change solutions",
    "limit": 3,
    "type": "News"
  }
}

Kagi Summarization

Summarize web pages using Kagi's FastGPT API.

Parameters:

• url (string, required): The URL of the web page to summarize.
• engine (string, optional): The summarization engine to use ("cecil", "agnes", or "muriel", default: "agnes").
• summary_type (string, optional): The type of summary to generate ("summary", "bullets", default: "summary").

Example:

{
  "name": "kagi_summarize",
  "arguments": {
    "url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
    "engine": "cecil",
    "summary_type": "summary"
  }
}

Integration Examples

Integration with Claude

You can connect Claude to this MCP server to enable it to search the web and summarize web pages.

1. Start the server in stdio mode.
2. Configure Claude to use it as an MCP tool.

{
  "mcpServers": {
    "kagi": {
      "command": "./kagimcp",
      "args": [],
      "env": {
        "KAGI_API_KEY": "your_api_key"
      }
    }
  }
}

Integration with Other Platforms

Integrate this server with other platforms that support the MCP protocol to easily expand their functionality.

📄 License

Refer to the project repository for specific license information.