What is Claude Search Mcp

claude-search-mcp is an MCP server that provides web search capabilities using the Claude API, enabling LLMs to access up-to-date information from the web through a standardized interface.

Use cases

Use cases include enhancing chatbots with real-time information retrieval, providing up-to-date data for research applications, and enabling automated customer support systems to fetch relevant web content.

How to use

To use claude-search-mcp, clone the repository, install dependencies, build the server, and link it for global access. Configure the Claude Desktop app to manage the server by adding the server details to the MCP server configuration file.

Key features

Key features include a web search tool using Claude’s web search API, support for domain filtering (allowed and blocked domains), configurable maximum results per search, and automatic configuration from the Claude Desktop config file.

Where to use

claude-search-mcp can be used in various fields that require real-time web search capabilities, such as research, data analysis, customer support, and content generation.

Claude Web Search MCP Server

This MCP (Model Context Protocol) server provides web search capabilities using the Claude API. It allows LLMs to access up-to-date information from the web through a standardized interface.

Features

• Web search tool using Claude’s web search API
• Support for domain filtering (allowed and blocked domains)
• Configurable maximum results per search
• Automatic configuration from Claude Desktop config file

Prerequisites

• Node.js 18 or higher
• An Anthropic API key with web search enabled
• Claude Desktop app for testing

Installation & Setup

1. Clone the repository:

   git clone https://github.com/Doriandarko/claude-search-mcp.git
   cd claude-search-mcp
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

   This compiles the TypeScript code and makes the server executable.

4. Link the server for global access:

   npm link
   

   This makes the mcp-server-claude-search command available system-wide, allowing the Claude Desktop app to find it.

Running the Server with Claude Desktop App

Once the server is installed and linked, the Claude Desktop app can manage it automatically if configured correctly.

1. Configure Claude Desktop App:
   Open your Claude Desktop app’s MCP server configuration file (usually claude_desktop_config.json). Add or update the entry for this server:

   Replace "YOUR_ANTHROPIC_API_KEY_HERE" with your actual Anthropic API key. The server will also attempt to read this key from ~/code/claude-search-mcp/claude_desktop_config.json if the env variable is not set here, but it’s good practice to define it per-server in the main config.

2. Launch Claude Desktop App:
   Start (or restart) your Claude Desktop application. It should now be able to find and launch the mcp-server-claude-search when needed.

3. Use Web Search:
   You can now use web search capabilities in your conversations with Claude.

Manual Server Execution (for testing/development)

If you want to run the server manually for testing or development purposes (outside of the Claude Desktop app management):

• Using the globally linked command:

  mcp-server-claude-search
  

• Directly with tsx (for development with auto-restart):

  npm run dev
  

• Running the compiled code directly:

  npm start
  

Web Search Tool Parameters

The web search tool supports the following parameters when called by an LLM:

• query (required): The search query string.
• maxResults (optional): Maximum number of search results to return (default: 5).
• allowedDomains (optional): Array of domains to include in search results (e.g., ["example.com", "wikipedia.org"]).
• blockedDomains (optional): Array of domains to exclude from search results.

License

MIT