parquet_mcp_server

by DeepSpringAI

2 stars
156 downloads
Not rated
GitHub

Description

# parquet_mcp_server [![smithery badge](https://smithery.ai/badge/@DeepSpringAI/parquet_mcp_server)](https://smithery.ai/server/@DeepSpringAI/parquet_mcp_server) A powerful MCP (Model Control Protocol) server that provides tools for performing web searches and finding similar…

About

# parquet_mcp_server [![smithery badge](https://smithery.ai/badge/@DeepSpringAI/parquet_mcp_server)](https://smithery.ai/server/@DeepSpringAI/parquet_mcp_server) A powerful MCP (Model Control Protocol) server that provides tools for performing web searches and finding similar content. This server is designed to work…

Details

Author
DeepSpringAI
GitHub stars
2
Downloads
156
Categories
Search, Other, AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name parquet_mcp_server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

{
  "mcpServers": {
    "search_mcp_server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@DeepSpringAI/parquet_mcp_server",
        "--client",
        "claude"
      ]
    }
  }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "parquet_mcp_server": {
            "search_mcp_server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@DeepSpringAI/parquet_mcp_server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "search_mcp_server": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@DeepSpringAI/parquet_mcp_server",
            "--client",
            "claude"
        ]
    }
}

parquet_mcp_server

smithery badge

A powerful MCP (Model Control Protocol) server that provides tools for performing web searches and finding similar content. This server is designed to work with Claude Desktop and offers two main functionalities:

1. Web Search: Perform a web search and scrape results
2. Similarity Search: Extract relevant information from previous searches

This server is particularly useful for:
- Applications requiring web search capabilities
- Projects needing to find similar content based on search queries

Installation

Installing via Smithery

To install Parquet MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @DeepSpringAI/parquet_mcp_server --client claude

Clone this repository

git clone ...
cd parquet_mcp_server

Create and activate virtual environment

uv venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

Install the package

uv pip install -e .

Environment

Create a .env file with the following variables:

EMBEDDING_URL=http://sample-url.com/api/embed  # URL for the embedding service
OLLAMA_URL=http://sample-url.com/  # URL for Ollama server
EMBEDDING_MODEL=sample-model  # Model to use for generating embeddings
SEARCHAPI_API_KEY=your_searchapi_api_key
FIRECRAWL_API_KEY=your_firecrawl_api_key
VOYAGE_API_KEY=your_voyage_api_key
AZURE_OPENAI_ENDPOINT=http://sample-url.com/azure_openai
AZURE_OPENAI_API_KEY=your_azure_openai_api_key

Usage with Claude Desktop

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "parquet-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/home/${USER}/workspace/parquet_mcp_server/src/parquet_mcp_server",
        "run",
        "main.py"
      ]
    }
  }
}

Available Tools

The server provides two main tools:

1. Search Web: Perform a web search and scrape results
- Required parameters:
- queries: List of search queries
- Optional parameters:
- page_number: Page number for the search results (defaults to 1)

2. Extract Info from Search: Extract relevant information from previous searches
- Required parameters:
- queries: List of search queries to merge

Example Prompts

Here are some example prompts you can use with the agent:

For Web Search:

"Please perform a web search for 'macbook' and 'laptop' and scrape the results from page 1"

For Extracting Info from Search:

"Please extract relevant information from the previous searches for 'macbook'"

Testing the MCP Server

The project includes a comprehensive test suite in the src/tests directory. You can run all tests using:

python src/tests/run_tests.py

Or run individual tests:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.