metasearch-mcp

MIT License
1
  • Apple
  • Linux

Integrations

  • Provides a Docker Compose setup to run the MCP server and client in a local environment for operating systems where Claude Desktop is not available

metasearch MCP server

A MCP server for metasearch

Components

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.

Tools

This server implements the following tools:

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

Install

  1. Download the repository.
git clone https://github.com/YeonwooSung/metasearch-mcp.git
  1. 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`
  1. 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" } } }
  1. Restart Claude Desktop.

Usage

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.

Log Storage Location

Logs are stored in the following location:

For Windows:

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

Execution with Cursor

  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
  1. Configure Cursor's MCP Server settings as follows:
Name: tavily-search Type: command Command: /path/to/your/script.sh
  1. Save the settings.
  2. Once the settings are saved, you can ask Cursor's Composer-Agent to "search for something," and it will return the search results.

Running in Local Environment Using Docker Compose

Purpose

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.

Steps

  1. Install Docker.
  2. Download the repository.
git clone https://github.com/YeonwooSung/metasearch-mcp.git
  1. Run Docker compose.
docker compose up -d
  1. Execute the client.
docker exec mcp_server uv --directory /usr/src/app/mcp-server-tavily/src run client.py
  1. Execution Results
  2. After searching for available tools as shown below, a query will be issued to Tavily and a response will be returned
-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

MCP server for using various search tools like Tavily API. Planning to support various search tools (i.e. wiki search, searxng, etc)

  1. Components
    1. Tools
    2. Install
  2. Usage
    1. Log Storage Location
      1. Execution with Cursor
        1. Running in Local Environment Using Docker Compose
          1. Purpose
          2. Steps

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          An MCP server implementation that integrates the Brave Search API, providing both web and local search capabilities.
          Last updated -
          2
          20,301
          44,922
          JavaScript
          MIT License
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          An MCP server implementation that integrates the SearxNG API, providing web search capabilities.
          Last updated -
          2
          633
          63
          JavaScript
          MIT License
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          An MCP server implementation that integrates the Tavily Search API, providing optimized search capabilities for LLMs.
          Last updated -
          1
          TypeScript
          MIT License
          • Apple
        • -
          security
          F
          license
          -
          quality
          An MCP server that integrates with SerpApi to retrieve search results from multiple search engines including Google, Bing, Yahoo, and others, enabling fast access to both live and archived search data.
          Last updated -
          Python

        View all related MCP servers

        ID: xxb4uogn02