MCP 服务器

parquet mcp server

一个强大的 MCP (模型控制协议) 服务器，提供用于操作和分析 Parquet 文件的工具。该服务器旨在与 Claude Desktop 配合使用，并提供四个主要功能：

README

parquet_mcp_server

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

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

此服务器特别适用于：

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

安装

通过 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  # 在 Windows 上
source .venv/bin/activate  # 在 macOS/Linux 上

安装包

uv pip install -e .

环境变量

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

EMBEDDING_URL=http://sample-url.com/api/embed  # Embedding 服务的 URL
OLLAMA_URL=http://sample-url.com/  # Ollama 服务器的 URL
EMBEDDING_MODEL=sample-model  # 用于生成 Embedding 的模型
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"
      ]
    }
  }
}

可用工具

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

搜索网页: 执行网络搜索并抓取结果
- 必需参数：
  - queries: 搜索查询列表
- 可选参数：
  - page_number: 搜索结果的页码（默认为 1）
从搜索中提取信息: 从之前的搜索中提取相关信息
- 必需参数：
  - queries: 要合并的搜索查询列表

示例提示

以下是一些您可以与代理一起使用的示例提示：

用于网络搜索：

"请执行对 'macbook' 和 'laptop' 的网络搜索，并抓取第 1 页的结果"

用于从搜索中提取信息：

"请从之前对 'macbook' 的搜索中提取相关信息"

测试 MCP 服务器

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

python src/tests/run_tests.py

或者运行单个测试：

# 测试网络搜索
python src/tests/test_search_web.py

# 测试从搜索中提取信息
python src/tests/test_extract_info_from_search.py

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

from parquet_mcp_server.client import (
    perform_search_and_scrape,  # 新的网络搜索函数
    find_similar_chunks  # 新的提取信息函数
)

# 执行网络搜索
perform_search_and_scrape(["macbook", "laptop"], page_number=1)

# 从搜索结果中提取信息
find_similar_chunks(["macbook"])

故障排除

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