Ac3xx MCP Servers Kagi

🚀 Kagi-server MCP Server

An MCP server integrated with the Kagi API

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

• A tool for web search and other operations using Kagi.
  • Currently in a private beta phase.

✨ Features

Implemented Tools

• kagi_search - Perform web searches using Kagi.
  • Accepts a query string and optional limit parameters.
  • Returns search results from the Kagi API.

Planned Tools (Not Yet Implemented)

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

🛠️ Development

Install Dependencies

npm install

Build the Server

npm run build

Feature Development with Automatic Rebuilding

npm run watch

⚙️ Environment Configuration

Create a .env file in the project root directory and add your Kagi API key:

KAGI_API_KEY=your_api_key_here

Make sure to add .env to your .gitignore file to protect your API key.

📦 Installation

Install via Smithery

To automatically install the Kagi Server for Claude Desktop via Smithery:

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

To use it with Claude Desktop, add the following server configuration:

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 via standard input and output, debugging can be challenging. We recommend using MCP Inspector, which is provided as a package script:

npm run inspector

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

💻 Usage Examples

Basic Usage

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

1. Ask Claude: "Can you find information about the latest developments in quantum computing?"
2. Claude will use the kagi_search tool to get results from the Kagi API.
3. Claude will then summarize or analyze the search results to provide you with information.

⚠️ Important Note

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

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request. Some areas where you can contribute 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.

🚧 Future Plans

• Implement the kagi_summarize tool for web page and text summarization.
• Implement the kagi_fastgpt tool for quick responses.
• Implement the kagi_enrich tool for getting rich news results.
• Improve error handling and add more robust input validation.
• Add more comprehensive usage examples and documentation.
• Publish to npm for easy use with Claude Desktop and npx.