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
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:
Build the server:
For development with auto-rebuild:
Environment Setup
Create a
.env file in the root directory with your Kagi API key: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:
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.jsonDebugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
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_searchtool 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_summarizetool for webpage and text summarization
- Implement
kagi_fastgpttool for quick responses
- Implement
kagi_enrichtool 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
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
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:
Build the server:
For development with auto-rebuild:
Environment Setup
Create a
.env file in the root directory with your Kagi API key: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:
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.jsonDebugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
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_searchtool 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_summarizetool for webpage and text summarization
- Implement
kagi_fastgpttool for quick responses
- Implement
kagi_enrichtool 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