kagi-server MCP Server

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:

Ask Claude: "Can you search for information about the latest advancements in quantum computing?"
Claude will use the kagi_search tool to fetch results from Kagi's API.
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

@ac3xx/mcp-servers-kagi: kagi-server

Author

README