Metasearch

metasearch MCP server

Um servidor MCP para metasearch

Componentes

Este servidor usa a API Tavily para realizar buscas com base em consultas especificadas.

• Os resultados da busca são retornados em formato de texto.
• Os resultados da busca incluem respostas de IA, URIs e títulos dos resultados da busca.

Ferramentas

Este servidor implementa as seguintes ferramentas:

• search: Realiza buscas com base em consultas especificadas
  • Argumento obrigatório: "query"
  • Argumento opcional: "search_depth" (básico ou avançado)

Instalação

1. Baixe o repositório.

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

2. Abra o arquivo de configuração do Claude Desktop.

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

3. Edite o arquivo de configuração da seguinte forma:

"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. Reinicie o Claude Desktop.

Uso

No Claude Desktop, quando você perguntar "Por favor, pesquise algo", você receberá os resultados da busca.

Exemplo de busca:

Please search in detail for today's events in Kamakura

Exemplo de resposta:

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.

Local de Armazenamento de Logs

Os logs são armazenados no seguinte local:

Para Windows:

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

Execução com Cursor

1. Crie um script de shell (por exemplo, script.sh) conforme mostrado abaixo:

#!/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 as configurações do MCP Server do Cursor da seguinte forma:

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

3. Salve as configurações.

4. Depois que as configurações forem salvas, você pode pedir ao Composer-Agent do Cursor para "pesquisar algo", e ele retornará os resultados da busca.

Execução em Ambiente Local Usando Docker Compose

Objetivo

Para sistemas operacionais diferentes de Windows/MacOS onde o Claude Desktop não pode ser usado, esta seção explica como configurar e executar um servidor e cliente MCP em um ambiente local usando Docker compose.

Etapas

1. Instale o Docker.
2. Baixe o repositório.

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

3. Execute o Docker compose.

docker compose up -d

4. Execute o cliente.

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

5. Resultados da Execução
6. Após pesquisar pelas ferramentas disponíveis conforme mostrado abaixo, uma consulta será enviada ao Tavily e uma resposta será retornada