OneSQL MCP 服务器
OneSQL的模型上下文协议（MCP）服务器——基于AI的SQL查询生成与表提取工具。
特点/功能
- SQL生成 （付费）：使用Qwen2.5-Coder-7B + OneSQL PEFT将自然语言转换为SQL查询
- 模式管理 (付费功能)：上传、列出和删除数据库架构
- 表格提取 (FREE): 从文本文档中提取表格 - 无需API密钥！
安装
快速安装
pip install onesql-mcp-server手动安装
# Download the script
curl -O https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcp-server.py
# Make it executable
chmod +x onesql_mcp_server.py设置
1. 获取API密钥
对于付费的SQL功能，请从以下位置获取您的API密钥：
- AWS：https://aws.marketplace.amazon.com/pp/prodview-onesql（亚马逊云服务市场页面链接，可直接访问）
- GCP（Google Cloud Platform）: 请联系 support@onekq.ai
2. 配置Claude桌面版
添加到你的 claude_desktop_config.json:
macOS（发音为“Mac OS”，全称为“Macintosh Operating System”，即苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"onesql": {
"command": "python",
"args": ["/path/to/onesql_mcp_server.py"],
"env": {
"ONESQL_API_KEY": "your-api-key-here"
}
}
}
}3. 重启Claude桌面版
OneSQL 工具将出现在 Claude Desktop 的工具列表中。
用法
免费表格提取（无需API密钥！）
Extract tables from this text:
| Name | Age | City |
|------|-----|------|
| John | 25 | NYC |
| Jane | 30 | LA |SQL生成（需要API密钥）
Generate SQL to find all users who signed up in the last 30 days首先，上传您的架构：
Upload my database schema:
CREATE TABLE users (
id SERIAL PRIMARY KEY,
email VARCHAR(255),
created_at TIMESTAMP
);可用工具
| 工具 | 成本 | 描述 | ||
|---|---|---|---|---|
| 中文 | 英文 | 说明 | sql_generate_query | |
| 💰 支付版 | 从自然语言生成SQL | sql_upload_schema | ||
| 💰 已付费 | 上传数据库架构以提高准确性 | sql_list_schemas | ||
| 💰 已付费 | 列出您保存的模式 | sql_delete_schema | ||
| 💰 付费 | 删除模式 | extract_tables | ** | 免费** 免费 |
从文本中提取表格（无需API密钥！）
Claude Desktop
↓
OneSQL MCP Server (local bridge)
↓
OneSQL GCP API
↓
├─ Schema Service (Firestore)
└─ SQL Generation (GPU - Qwen2.5-Coder-7B)建筑学
- 定价表格提取
- 免费 - 无限使用，无需API密钥SQL生成
- 通过AWS/GCP Marketplace按查询付费模式管理
随SQL订阅一同提供
API 端点
https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcpMCP服务器连接到：
发展
export ONESQL_API_KEY="your-key"
python onesql_mcp_server.py本地运行
服务器从标准输入（stdin）读取JSON-RPC请求，并将响应写入标准输出（stdout）。
npx @modelcontextprotocol/inspector python onesql_mcp_server.py使用MCP Inspector进行测试
故障排除
- “ONESQL_API_KEY”环境变量是必需的
- 在Claude Desktop配置中设置环境变量（参见上方的设置步骤）
对于免费的表格提取，您可以使用占位符键或留空
- “网络错误”/“超时”
- 检查你的网络连接
curl https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcp
验证API端点是否可访问：
- 工具未在Claude桌面版中显示
- 配置更改后重启Claude桌面版
检查Claude Desktop日志中的错误
- 支持
- 问题：https://github.com/onekq/onesql-mcp-server/issues
- 电子邮箱：support@onekq.ai
文档链接：https://docs.onekq.ai
许可证
MIT 许可证 - 详情请参见 LICENSE 文件
- 链接
- MCP协议：https://modelcontextprotocol.io
- OneSQL: https://onekq.ai