A MCP server for metasearch

This server uses the Tavily API to perform searches based on specified queries.

• Search results are returned in text format.
• Search results include AI responses, URIs, and titles of the search results.

This server implements the following tools:

• search: Performs searches based on specified queries
  • Required argument: "query"
  • Optional argument: "search_depth" (basic or advanced)

1. Download the repository.

git clone https://github.com/YeonwooSung/metasearch-mcp.git

2. Open the Claude Desktop configuration file.

On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
On Windows: `C:\Users\[username]\AppData\Roaming\Claude\claude_desktop_config.json`

3. Edit the configuration file as follows:

"mcpServers": {
  "tavily-search": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\your_path\\mcp-server-tavily",
      "run",
      "tavily-search"
    ],
    "env": {
      "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY",
      "PYTHONIOENCODING": "utf-8"
    }
  }
}

4. Restart Claude Desktop.

In Claude Desktop, when you ask "Please search for something", you will receive search results.

Search example:

Please search in detail for today's events in Kamakura

Response example:

According to the search results, the following events start today, December 1st:
"Kamakura Promotion Photo Contest 2025"
Period: December 1, 2024 - January 31, 2025
A photo contest for those who love Kamakura
Applications start accepting from today
Also, as a related upcoming event:
On December 7th, an exhibition by 12 Kamakura artists will be held at the Seibu Press Inn Kamakura Ofuna Station East Exit Lounge.

Logs are stored in the following location:

For Windows:

C:\Users\[username]\AppData\Roaming\Claude\logs\mcp-server-tavily-search

1. Create a shell script (e.g., script.sh) as shown below:

#!/bin/bash
TARGET_DIR=/path/to/mcp-server-tavily
cd "${TARGET_DIR}"
export TAVILY_API_KEY="your-api-key"
export PYTHONIOENCODING=utf-8
uv --directory $PWD run tavily-search

2. Configure Cursor's MCP Server settings as follows:

Name: tavily-search
Type: command
Command: /path/to/your/script.sh

3. Save the settings.

4. Once the settings are saved, you can ask Cursor's Composer-Agent to "search for something," and it will return the search results.

For operating systems other than Windows/MacOS where Claude Desktop cannot be used, this section explains how to set up and run an MCP server and client in a local environment using Docker compose.

1. Install Docker.
2. Download the repository.

git clone https://github.com/YeonwooSung/metasearch-mcp.git

3. Run Docker compose.

docker compose up -d

4. Execute the client.

docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py

5. Execution Results
6. After searching for available tools as shown below, a query will be issued to Tavily and a response will be returned