MCP text2sql

MCP数据服务

提供方 AmiSharabi

数据服务 未标注 API Key 社区 / 第三方

一个具有安全防护、日志记录、下载功能和LLM集成测试的只读SQL Server MCP服务器。

一句话选型结论

按资料字段整理

MCP text2sql 属于数据服务类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

SQL查询Python本地部署数据库管理数据可视化日志记录LLM集成

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP text2sql当前 8 未标注 未标注 无 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AmiSharabi上游标注的维护方 AmiSharabi
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.7 KB
来自项目仓库与上游目录的原文,未做删改

# MCP Text2SQL PoC(本地+云)

只读SQL Server MCP服务器,带有护栏、日志记录、下载和LLM集成测试。

MCP工具

  • list_databases
  • get_schema
  • execute_readonly_sql
  • explain_reasoning
  • preview_table
  • download_result
  • download_mode=link (默认):将CSV保存在服务器上,返回URL
  • download_mode=base64:以base64内联返回CSV内容
  • build_chart
  • build_dashboard

大多数SQL工具接受可选 database 从中选择数据库配置文件 list_databases.

主要终点

  • POST /mcp
  • GET /sse
  • POST /messages?session_id=
  • POST /tools/get_schema
  • POST /tools/list_databases
  • POST /tools/execute_readonly_sql
  • POST /tools/explain_reasoning
  • POST /tools/preview_table
  • POST /tools/download_result
  • POST /tools/build_chart
  • POST /tools/build_dashboard
  • GET /downloads/.csv

设置

  1. python -m venv venv
  2. venv\\Scripts\\python.exe -m pip install -r requirements.txt
  3. 复制 .env.example 到 .env 并填充值。
    - 单个数据库:设置 DB_*
    - 多数据库:设置 DB_CATALOG_PATH 到现有的JSON文件(请参见 db_catalog.example.json)
  4. 运行服务器: venv\\Scripts\\python.exe mcp_server.py

云访问

云模型无法调用 127.0.0.1 直接。

  • 使用HTTPS隧道暴露本地服务器(示例: ngrok http 8000)
  • 对于基于SSE的MCP连接器,请使用 https:///sse 作为MCP服务器URL
  • 集 MCP_PUBLIC_BASE_URL 如果你想要绝对下载链接
  • 配置 x-api-key 在连接器中

项目文件

  • mcp_server.py
  • 薄兼容性入口点
  • 再出口 app 和 SSE_SESSIONS
  • 通过运行服务器 main()
  • src/mcp_app.py
  • FastAPI应用+所有HTTP/SSE路由
  • 山丘 /downloads/*
  • src/mcp_runtime.py
  • MCP JSON-RPC处理程序(initialize, tools/list, tools/call等等)
  • API密钥身份验证、跟踪/日志助手、SSE会话存储
  • src/mcp_models.py
  • Pydantic请求模型 /tools/*
  • src/tools.py
  • 工具实现:
  • list_databases
  • get_schema
  • execute_readonly_sql
  • explain_reasoning
  • preview_table
  • download_result (只读SQL->CSV)
  • build_chart
  • build_dashboard
  • src/guard.py
  • SQL安全规则:
  • 仅限单一声明
  • 仅选择
  • denylist危险代币
  • 块 SELECT INTO
  • 强制执行 TOP (SQL_MAX_ROWS)
  • 限制复杂性 SQL_MAX_TABLES
  • src/db_connection.py
  • SQLAlchemy+SQL Server连接层
  • 支持来自的传统单个数据库 .env 以及模块化多数据库 DB_CATALOG_PATH
  • db_catalog.example.json
  • 具有共享凭据和每个数据库名称的多数据库目录示例
  • src/logger.py
  • 事件记录接收器(file / sql / both)
  • SQL接收器写入SQL Server表(默认目标: mcp_logging.events)
  • 截断/清理字段(包括 user_prompt)
  • logs/sql/001_create_mcp_logging.sql
  • 用于在可观察性数据库中创建日志模式/表/索引/视图的SQL Server脚本
  • logs/sql/002_mcp_logging_analysis_queries.sql
  • 准备运行SQL查询以进行跟踪/会话/错误/性能分析
  • logs/sql/000_create_mcp_observability_db.sql
  • 创建专用的可观察性数据库(McpObservability 默认情况下)
  • logs/sql/003_mcp_logging_security_and_retention.sql
  • 创建最低权限角色/用户和保留过程
  • mcp_tools.json
  • MCP工具定义由返回 tools/list
  • logs/export_logs_csv.py
  • 出口 logs/events.jsonl 转换为CSV
  • 还导出列指南(CSV+XLSX)
  • 回填物缺失 user_prompt 通过 trace_id
  • logs/events.jsonl
  • 运行时事件日志(原始源)
  • logs/downloads/
  • CSV文件由创建 download_result 在 link 模式

日志和导出

  • JSONL运行时日志(原始): logs/events.jsonl
  • SQL日志接收器:
  • 建议的安装顺序:
    1. 跑 logs/sql/000_create_mcp_observability_db.sql
    1. 跑 logs/sql/001_create_mcp_logging.sql
    1. 跑 logs/sql/003_mcp_logging_security_and_retention.sql
  • 脚本默认为数据库名称 McpObservability (编辑 USE [...] 如果您选择其他名称)
  • 如果你没有 CREATE DATABASE 权限,请DBA预先创建 McpObservability 然后从步骤2开始
  • 使用专用数据库+专用登录记录写入(最低权限)
  • 集 .env:
  • LOG_SINK=sql (仅限SQL)或 LOG_SINK=both (SQL+jsonl)
  • 通过设置专用SQL日志连接 LOG_DB_* (推荐)
  • LOG_DB_HOST, LOG_DB_PORT, LOG_DB_NAME
  • LOG_DB_USER, LOG_DB_PASSWORD
  • LOG_DB_DRIVER, LOG_DB_ENCRYPT, LOG_DB_TRUST_SERVER_CERTIFICATE
  • 最低建议值:
  • LOG_DB_NAME=McpObservability
  • LOG_DB_USER=
  • LOG_DB_PASSWORD=
  • LOG_DB_* 行为:
  • 仅在以下情况下使用 LOG_SINK 是 sql 或 both
  • 按字段回退:如果 LOG_DB_* 缺失/为空,记录器恢复匹配 DB_*
  • 回退是针对每个变量的(不是全部或全无),因此是部分的 LOG_DB_* 配置有效
  • 如果 LOG_DB_HOST 是基于实例的(例如: AMI02\\SQLEXPRESS), LOG_DB_PORT 被忽略
  • 默认表目标: LOG_DB_SCHEMA=mcp_logging, LOG_DB_TABLE=events
  • 保留:
  • 计划执行SQL代理作业:
  • EXEC mcp_logging.usp_purge_events_older_than_days @retention_days = 90, @batch_size = 5000;
  • 如果SQL插入失败,记录器将回退JSONL写入 LOG_SQL_FALLBACK_PATH
  • 导出日志时使用:
  • venv\\Scripts\\python.exe logs/export_logs_csv.py
  • 可选的自定义输出路径:
  • --input logs/events.jsonl
  • --output logs/events.csv
  • --columns-guide-output logs/events_columns_guide.csv
  • --columns-guide-xlsx-output logs/events_columns_guide.xlsx
  • 导出行为:
  • 做 不 修改原始 logs/events.jsonl
  • 仅写入新的导出文件
  • 如果目标文件被锁定,则创建一个新的文件名,如下所示 *_new1.csv

备注

  • 要跨工具事件捕获原始激活提示,请传递 user_prompt (或 x-user-prompt 标题为 /mcp).

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP text2sql 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP text2sql 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP text2sql 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP text2sql 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

MCP text2sql 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 SQL查询、日志记录、Python、数据分析、数据可视化。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。