parquet_mcp_server

一个强大的MCP（模型控制协议）服务器，提供执行网络搜索和查找相似内容的工具。该服务器设计用于与Claude Desktop配合使用，并提供了两个主要功能：

1. 网络搜索：执行网络搜索并抓取结果
2. 相似性搜索：从之前的搜索中提取相关信息

该服务器特别适用于：

• 需要网络搜索能力的应用程序
• 需要根据搜索查询查找相似内容的项目

安装

通过Smithery安装

要通过Smithery自动为Claude Desktop安装Parquet MCP Server：

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

克隆此仓库

git clone ...
cd parquet_mcp_server

创建并激活虚拟环境

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

安装包

uv pip install -e .

环境

创建一个包含以下变量的.env文件：

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

与Claude Desktop一起使用

将以下内容添加到您的Claude Desktop配置文件（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"
      ]
    }
  }
}

可用工具

服务器提供了两个主要工具：

1. 搜索网络：执行网络搜索并抓取结果

   • 必需参数：
     • queries：搜索查询列表
   • 可选参数：
     • page_number：搜索结果的页码（默认为1）

2. 从搜索中提取信息：从之前的搜索中提取相关信息

   • 必需参数：
     • queries：要合并的搜索查询列表

示例提示

这里有一些您可以与代理一起使用的示例提示：

对于网络搜索：

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

对于从搜索中提取信息：

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

测试MCP服务器

项目在src/tests目录中包含了一个全面的测试套件。您可以使用以下命令运行所有测试：

python src/tests/run_tests.py

或者运行单个测试：

# Test Web Search
python src/tests/test_search_web.py

# Test Extract Info from Search
python src/tests/test_extract_info_from_search.py

您也可以直接使用客户端来测试服务器：

from parquet_mcp_server.client import (
    perform_search_and_scrape,  # New web search function
    find_similar_chunks  # New extract info function
)

# Perform a web search
perform_search_and_scrape(["macbook", "laptop"], page_number=1)

# Extract information from the search results
find_similar_chunks(["macbook"])

故障排除

1. 如果遇到SSL验证错误，请确保.env文件中的SSL设置正确。
2. 如果未生成嵌入向量，请检查：
   • Ollama服务器正在运行且可访问
   • 指定的模型在您的Ollama服务器上可用
   • 输入的Parquet文件中存在文本列
3. 如果DuckDB转换失败，请检查：
   • 输入的Parquet文件存在且可读
   • 您在输出目录中有写权限
   • Parquet文件未损坏
4. 如果PostgreSQL转换失败，请检查：
   • .env文件中的PostgreSQL连接设置是否正确
   • PostgreSQL服务器正在运行且可访问
   • 您有创建/修改表的必要权限
   • 数据库中已安装pgvector扩展