QueryPie MCP

基本能力

产品定位

QueryPie MCP Server 是一个管理控制协议服务器，主要用于管理员对 QueryPie 服务进行管理和配置。

核心功能

1. 提供多种安装和运行方式（Docker、Linux/macOS 二进制安装）。
2. 支持 stdio 和 SSE（Server-Sent Events）两种传输方式。
3. 可以与 Claude Desktop 和 Cursor 等开发工具集成。

适用场景

1. 管理员需要集中管理 QueryPie 服务。
2. 开发者在本地或远程环境中配置和运行 QueryPie 服务。
3. 需要将 QueryPie 服务集成到其他开发工具中。

工具列表

1. Docker：通过 Docker 容器快速部署和运行 QueryPie MCP Server。
2. Linux/macOS 二进制：直接下载并运行二进制文件，适用于本地开发环境。
3. Claude Desktop 和 Cursor：通过配置文件将 QueryPie MCP Server 集成到这些开发工具中。

常见问题解答

1. 如何获取 API Key：在 QueryPie 网页控制台的 General > System > API Token 中获取。
2. 如何配置 SSE 模式：在运行命令中添加 --transport sse 和 --port 参数。

使用教程

使用依赖

1. 准备 QueryPie API Key 和 URL。
2. 确保已安装 Docker（如需使用 Docker 方式）。

安装教程

Docker 安装

# Stdio 示例
export QUERYPIE_API_KEY=your_token
export QUERYPIE_URL=https://your_querypie_url

docker run --rm \
    -e "QUERYPIE_API_KEY=${QUERYPIE_API_KEY}" \
    ghcr.io/querypie/querypie-mcp-server "${QUERYPIE_URL}"

# SSE 示例
export QUERYPIE_API_KEY=your_token
export QUERYPIE_URL=https://your_querypie_url

docker run --rm \
    -e "QUERYPIE_API_KEY=${QUERYPIE_API_KEY}" \
    ghcr.io/querypie/querypie-mcp-server "${QUERYPIE_URL}" \
    --transport sse \
    --port 8000

Linux/macOS 安装

# 安装 querypie-mcp-server 二进制到 ~/.local/bin
curl -L https://github.com/querypie/querypie-mcp-server/releases/latest/download/install.sh | sh

# Stdio 示例
export QUERYPIE_API_KEY=your_token
querypie-mcp-server https://your_querypie_url

# SSE 示例
export QUERYPIE_API_KEY=your_token
querypie-mcp-server https://your_querypie_url \
    --transport sse \
    --port 8000

调试方式

1. 确保环境变量 QUERYPIE_API_KEY 和 QUERYPIE_URL 已正确设置。
2. 检查 Docker 容器或二进制文件是否正常运行。
3. 查看日志输出以排查问题。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。