MCP ExplorerExplorer

Mcp Servers Kagi

@ac3xxon 9 months ago
33 MIT
FreeCommunity
AI Systems
#kagi#model-context-protocol
A Model Context Protocol server implementation for Kagi's API

Overview

What is Mcp Servers Kagi

mcp-servers-kagi is a Model Context Protocol server implementation designed for integrating with Kagi’s Search API, allowing users to perform web searches and other operations.

Use cases

Use cases include integrating Kagi search functionality into applications, automating web searches for research purposes, and enhancing user experience with summarized content and enriched news.

How to use

To use mcp-servers-kagi, install the necessary dependencies with ‘npm install’, build the server using ‘npm run build’, and create a ‘.env’ file with your Kagi API key. You can also install it via Smithery for easier integration.

Key features

Key features include the ‘kagi_search’ tool for performing web searches, with planned tools like ‘kagi_summarize’ for generating summaries, ‘kagi_fastgpt’ for quick responses, and ‘kagi_enrich’ for fetching enriched news results.

Where to use

mcp-servers-kagi can be used in various fields such as web development, data analysis, and any application requiring advanced search capabilities through Kagi’s API.

Content

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:

npm install

Build the server:

npm run build

For development with auto-rebuild:

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:

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

{
  "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:

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers