Kagi Server Mcp Server

What is mcp-servers-kagi?

The ### mcp-servers-kagi is a Model Context Protocol (MCP) server implementation designed specifically for Kagi's API. This project aims to facilitate seamless interactions with Kagi's services by providing a robust server framework that adheres to the Model Context Protocol standards. It allows developers to integrate Kagi's functionalities into their applications efficiently.

Features of mcp-servers-kagi

• MCP Compliance: Fully compliant with the Model Context Protocol, ensuring compatibility with various applications and services.
• API Integration: Simplifies the integration of Kagi's API, allowing developers to leverage its features without extensive setup.
• Public Repository: The project is open-source and available on GitHub, encouraging collaboration and contributions from the community.
• Active Development: Regular updates and improvements are made to enhance functionality and performance.
• Documentation: Comprehensive documentation is provided to assist developers in understanding and utilizing the server effectively.

How to Use mcp-servers-kagi

1. Clone the Repository: Start by cloning the mcp-servers-kagi repository from GitHub to your local machine.

   git clone https://github.com/ac3xx/mcp-servers-kagi.git
   

2. Install Dependencies: Navigate to the project directory and install the necessary dependencies.

   cd mcp-servers-kagi
   npm install
   

3. Configuration: Configure the server settings according to your requirements. This may include API keys, endpoints, and other parameters.

4. Run the Server: Start the server to begin handling requests.

   npm start
   

5. Access the API: Use the provided endpoints to interact with Kagi's services through the MCP server.

Frequently Asked Questions

What is the Model Context Protocol?

The Model Context Protocol is a standard designed to facilitate communication between different systems and applications. It provides a structured way to exchange data and commands, ensuring interoperability among various platforms.

Is mcp-servers-kagi free to use?

Yes, mcp-servers-kagi is an open-source project released under the MIT license, allowing anyone to use, modify, and distribute the software freely.

How can I contribute to the project?

Contributions are welcome! You can contribute by reporting issues, submitting feature requests, or creating pull requests with improvements or bug fixes. Please refer to the contribution guidelines in the repository for more details.

Where can I find the documentation?

The documentation for mcp-servers-kagi is available in the repository. You can also visit the official Model Context Protocol website for additional resources and information.

How can I report a bug?

If you encounter any issues while using mcp-servers-kagi, please report them on the GitHub issues page of the repository. Provide as much detail as possible to help the maintainers address the problem effectively.

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:

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