BlazeSQL MCP Server

BlazeSQL MCP 服务

blaze-sql-server 是一款默认安全的 MCP 服务和 CLI，用于 BlazeSQL 自然语言查询 API。

它支持两种模式：

• serve：作为 MCP stdio 服务运行，供 Cursor、Claude Desktop、Codex 和其他 MCP 客户端使用
• query：直接在 shell 中执行单次 BlazeSQL 请求

亮点

• MCP 工具：提供 blazesql_query
• CLI 命令：serve、query、doctor、help、version
• 安全默认设置：仅使用 HTTPS 的远程端点、受限超时、日志脱敏、限制格式化输出
• 验证：运行时配置验证，以及 BlazeSQL 响应结构验证
• 工具链：pnpm、CI、自动化测试和项目级 mcporter 配置

要求

• Node.js >=20.11.0
• pnpm >=10
• BlazeSQL API 密钥

安装

pnpm install
cp .env.sample .env

至少设置：

BLAZE_API_KEY=YOUR_API_KEY_HERE

可选环境变量：

• BLAZE_API_ENDPOINT
• BLAZE_REQUEST_TIMEOUT_MS
• BLAZE_MAX_RESPONSE_CHARS
• BLAZE_LOG_LEVEL
• BLAZE_ALLOW_INSECURE_ENDPOINT

构建

pnpm build

作为 MCP 服务运行

为保持向后兼容，不带参数运行二进制文件会启动 stdio 服务：

node build/index.js

显式运行：

node build/index.js serve

提供的 MCP 工具为：

• blazesql_query
• db_id：BlazeSQL 数据库 ID
• natural_language_request：要发送给 BlazeSQL 的提示词

与 MCPorter 配合使用

MCPorter 可通过项目级配置 config/mcporter.json 自动发现此服务。

在项目根目录中：

npx mcporter list
npx mcporter call blazesql.blazesql_query db_id:"your_db_id" natural_language_request:"show me total users"

在任意位置临时使用：

npx mcporter call --stdio "node /path/to/blaze-sql-mcp-server/build/index.js" --name blazesql blazesql.blazesql_query db_id:"your_db_id" natural_language_request:"total sales last month"

作为 CLI 运行

打印帮助信息：

node build/index.js --help

执行直接查询：

node build/index.js query --db-id db_demo --request "show me total users by city"

使用位置参数：

node build/index.js query db_demo "show me total users by city"

从 stdin 读取请求：

printf 'show me total users by city\n' | node build/index.js query db_demo --stdin

可用的输出格式：

node build/index.js query db_demo "show me total users by city" --format markdown
node build/index.js query db_demo "show me total users by city" --format text
node build/index.js query db_demo "show me total users by city" --format json

诊断

检查运行时配置：

node build/index.js doctor
node build/index.js doctor --json

doctor 可安全地在共享终端中运行：它绝不会打印原始 API 密钥。

验证

pnpm typecheck
pnpm test
pnpm check

MCP 客户端配置

stdio 命令示例：

/absolute/path/to/node /absolute/path/to/blaze-sql-mcp-server/build/index.js

由于该二进制文件默认运行 serve，MCP 客户端无需添加额外子命令。

设计说明

CLI 的设计有意遵循由 mcporter 等工具推广的单一用途命令模式：提供可预测的命令界面、支持直接在 shell 中使用，并在需要时提供一种明确的机器可读模式。