kagi-server MCP Server

kagi-server MCP Server

TypeScript-based MCP server for Kagi Search API integration.

40
Stars
11
Forks
40
Watchers
6
Issues
Kagi-server MCP Server provides a TypeScript implementation of a Model Context Protocol (MCP) server that integrates with the Kagi Search API. It enables standardized tool access for performing web searches and plans for features like summarization, FastGPT integration, and enriched news results. Compatible with Claude Desktop and Smithery installations, it supports secure environment configuration and offers developer utilities such as automatic build and debugging via MCP Inspector.

Key Features

Tool for performing web searches using Kagi API
TypeScript-based MCP server implementation
Support for Claude Desktop integration
Planned tools for summarization, FastGPT, and enriched news
Secure API key management via .env files
Smithery automated installation support
Stdio-based interprocess communication
Debugging with MCP Inspector utility
Automatic rebuild and development scripts
MIT licensed open-source project

Use Cases

Performing real-time web searches within conversational AI platforms
Integrating Kagi Search API results into AI-driven workflows
Extending Claude Desktop with external search and summarization tools
Automated installation of custom tools for conversational agents
Developing and debugging custom MCP servers for context enrichment
Implementing secure third-party API integrations in AI environments
Providing contextually-relevant search results to AI models
Facilitating collaborative development for protocol-driven AI enhancement
Summarizing and enriching retrieved web data for user queries
Rapid prototyping of new tools for conversational context management

README

kagi-server MCP Server

smithery badge MCP server for Kagi API integration

This is a TypeScript-based MCP server that integrates the Kagi Search API. It demonstrates core MCP concepts by providing:

  • Tools for performing web searches and other operations using Kagi's API (currently in private beta)

Features

Implemented Tools

  • kagi_search - Perform web searches using Kagi
    • Takes a query string and optional limit as parameters
    • Returns search results from Kagi's API

Planned Tools (Not Yet Implemented)

  • kagi_summarize - Generate summaries of web pages or text
  • kagi_fastgpt - Get quick responses using Kagi's FastGPT
  • kagi_enrich - Fetch enriched news results on specific topics

Development

Install dependencies:

bash
npm install

Build the server:

bash
npm run build

For development with auto-rebuild:

bash
npm run watch

Environment Setup

Create a .env file in the root directory with your Kagi API key:

KAGI_API_KEY=your_api_key_here

Make sure to add .env to your .gitignore file to keep your API key secure.

Installation

Installing via Smithery

To install Kagi Server for Claude Desktop automatically via Smithery:

bash
npx @smithery/cli install kagi-server --client claude

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

json
{
  "mcpServers": {
    "kagi-server": {
      "command": "/path/to/kagi-server/build/index.js",
      "env": {
        "KAGI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

bash
npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Usage

Once the server is running and connected to Claude Desktop, you can use it to perform web searches. For example:

  1. Ask Claude: "Can you search for information about the latest advancements in quantum computing?"
  2. Claude will use the kagi_search tool to fetch results from Kagi's API.
  3. Claude will then summarize or analyze the search results for you.

Note: The planned tools (summarize, fastgpt, enrich) are not yet implemented and cannot be used.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Some areas for contribution include:

  • Implementing the planned tools (summarize, fastgpt, enrich)
  • Improving error handling and input validation
  • Enhancing documentation and usage examples

License

This project is licensed under the MIT License.

Roadmap

  • Implement kagi_summarize tool for webpage and text summarization
  • Implement kagi_fastgpt tool for quick responses
  • Implement kagi_enrich tool for fetching enriched news results
  • Improve error handling and add more robust input validation
  • Add more comprehensive usage examples and documentation
  • Publish the package to npm for easy installation and use with Claude Desktop and npx

Star History

Star History Chart

Repository Owner

ac3xx
ac3xx

User

Repository Details

Language TypeScript
Default Branch main
Size 51 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
80.24%
JavaScript
19.76%

Tags

Topics

kagi model-context-protocol

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Kagi MCP Server

    Kagi MCP Server

    Integrate Kagi Search and Summarization as Model Context Protocol tools.

    Kagi MCP Server enables easy integration of Kagi's search and summarization capabilities with AI systems via the Model Context Protocol. It facilitates tool-based queries such as searching web results or summarizing content, and offers setup instructions for various platforms including Claude Desktop. Users can install and configure the server through package managers, Smithery, or direct Python environments. The project provides configurable environment variables for API access and summarization engine selection, supporting both local development and production usage.

    • 216
    • MCP
    • kagisearch/kagimcp
  • NYTimes Article Search MCP Server

    NYTimes Article Search MCP Server

    Search New York Times articles via a Model Context Protocol server.

    NYTimes Article Search MCP Server is a TypeScript-based implementation of the Model Context Protocol that enables searching for New York Times articles from the past 30 days using keywords. It integrates with the official New York Times API and exposes a tool for streamlined article queries. Designed for use with systems like Claude Desktop, it includes support for installation via Smithery and provides development utilities such as an inspector for debugging MCP communication. The server handles MCP requests over stdio and securely accesses the NYT API via environment variables.

    • 15
    • MCP
    • angheljf/nyt
  • Confluence Communication Server MCP Server

    Confluence Communication Server MCP Server

    Seamlessly interact with Confluence using standardized MCP tools.

    Confluence Communication Server MCP Server is a TypeScript-based implementation that enables seamless interaction with Confluence through the Model Context Protocol. It provides tools for running CQL queries, retrieving, and updating Confluence page content, thus showcasing and adhering to core MCP concepts. The server is compatible with Claude Desktop and supports installation via Smithery, emphasizing ease of integration and automation for Confluence management tasks.

    • 13
    • MCP
    • KS-GEN-AI/confluence-mcp-server
  • tavily-search MCP server

    tavily-search MCP server

    A search server that integrates Tavily API with Model Context Protocol tools.

    tavily-search MCP server provides an MCP-compliant server to perform search queries using the Tavily API. It returns search results in text format, including AI responses, URLs, and result titles. The server is designed for easy integration with clients like Claude Desktop or Cursor and supports both local and Docker-based deployment. It facilitates AI workflows by offering search functionality as part of a standardized protocol interface.

    • 44
    • MCP
    • Tomatio13/mcp-server-tavily
  • Brave Search MCP Server

    Brave Search MCP Server

    MCP-compliant server providing advanced Brave Search API tools via STDIO and HTTP.

    Implements a Model Context Protocol (MCP) server for integrating with the Brave Search API, offering tools for web, local business, image, video, and news searches along with AI-powered summarization. Supports both STDIO and HTTP transports and adheres to established MCP conventions for context management. Provides structured tool schemas and customizable parameters to handle sophisticated search queries and results. Enables advanced filtering, multi-type result aggregation, and seamless integration for AI model workflows.

    • 337
    • MCP
    • brave/brave-search-mcp-server
  • MCP ChatGPT Server

    MCP ChatGPT Server

    Enables direct access to OpenAI's ChatGPT API from Claude Desktop via the Model Context Protocol.

    MCP ChatGPT Server runs as an MCP-compliant server, allowing users to access OpenAI's ChatGPT API seamlessly within Claude Desktop. It supports customizable model parameters, automated conversation state management, integrated web search for up-to-date information, and facilitates interactive discussions between Claude and ChatGPT. Users can configure model selection, temperature, token limits, and use their own OpenAI API keys.

    • 14
    • MCP
    • billster45/mcp-chatgpt-responses
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results