# Smart Search MCP Server
An MCP server implementation that integrates a remote smart search API, providing powerful web search capabilities.
## Features
- **Web Search**: Perform web searches with controls for result count, pagination, language, and safety level.
- **Structured JSON Output**: All search results are returned in a clean JSON format.
- **Easy Integration**: Designed for seamless use with any MCP-compatible client.
## Tools
### `smart_search`
Executes a web search with filtering and pagination options.
**Inputs:**
- `query` (string): The search terms.
- `count` (number, optional): The number of results to return (default: 10).
## Configuration
### Getting an API Key
1. Sign up for an account with the search API provider.
2. Generate your API key. The key should be in the format `endpoint-apikey`.
### Environment Variable
This server requires the `SERVER_KEY` environment variable to be set to your API key.
## Usage with an MCP Client
To use this server with a client like OpenWebUI or Claude Desktop, add the following configuration. This example uses `npx` to run the server directly from the npm registry.
## Development
Install dependencies:
```bash
npm install
```
Build the server:
```bash
npm run build
```
For development with auto-rebuild:
```bash
npm run watch
```
## Installation
### Installing via Smithery
To install SmartSearch Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@pgzhang/smartsearch-mcp):
```bash
npx -y @smithery/cli install @pgzhang/smartsearch-mcp --client claude
```
To use with Claude Desktop, add the server config with your Google API credentials:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"smart-search": {
"command": "npx",
"args": [
"-y",
"sktale"
],
"env": {
"AK": "YOUR_API_KEY_HERE",
"ENDPOINT": "YOUR_ENDPOINT_HERE"
}
}
}
}
```
## Usage
### Search Tool
```json
{
"name": "search",
"arguments": {
"query": "your search query",
"count": 5 // optional, default is 10, max is 50
}
}
```
## License
This MCP server is released under the MIT License. See the LICENSE file for more details.
