Smart Search

Provides web search via a remote smart search API with structured JSON results for MCP clients.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pgzhang-smartsearch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pgzhang/smartsearch-mcp"
      ],
      "env": {
        "AK": "YOUR_API_KEY_HERE",
        "ENDPOINT": "YOUR_ENDPOINT_HERE",
        "SERVER_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can add Smart Search MCP Server to your MCP client to perform web searches via a remote smart search API and receive structured JSON results. This server is designed for easy integration with any MCP-compatible client and supports configurable search parameters, API key authentication, and simple setup.

How to use

Use this server with your MCP client to perform web searches and retrieve results in a consistent JSON format. You can specify the query and optional result count, then process or display the results in your application. The server is designed to work with standard MCP tooling and supports environment-based API key configuration to keep credentials secure.

How to install

Prerequisites you need before installing:

Install Node.js and npm on your system. You can verify installation with node -v and npm -v.

Install dependencies and build the server for development and production use.

How to install

# Install the server package (via Smithery) and prepare for Claude Desktop integration
npx -y @smithery/cli install @pgzhang/smartsearch-mcp --client claude

How to install

Configure the MCP server with your API credentials. For Claude Desktop integration, you will include your Google API credentials in the client config as shown in the example below.

{
  "mcpServers": {
    "smart-search": {
      "command": "npx",
      "args": [
        "-y",
        "@pgzhang/smartsearch-mcp"
      ],
      "env": {
        "AK": "YOUR_API_KEY_HERE",
        "ENDPOINT": "YOUR_ENDPOINT_HERE"
      }
    }
  }
}

How to install

If you are configuring Claude Desktop on macOS or Windows, you may place the server configuration in the standard Claude desktop config file paths.

How to install

Tips for running during development include building with npm and watching for auto-rebuilds.

npm install
npm run build
npm run watch

How to install

If you prefer to run locally via npm without Smithery, you can use the following flow.

Note: The exact commands for your environment may vary based on how you package and run the MCP server.

Available tools

smart_search

Executes a web search with filtering and pagination options. Inputs include query and an optional count for the number of results.