text2sql

Name: text2sql
Author: cpenniman12

本地服务

github.com/cpenniman12数据库113 周前更新

代码仓库

关于 text2sql

text2sql 是用于自然语言查询 SQL 数据库的 MCP 服务。它会探索数据库结构、执行生成的 SQL 并纠正错误，无需 RAG 层或预先计算的嵌入。

主要功能

01用自然语言查询数据库
02探索数据库结构
03执行 SQL 并纠正错误
04支持 SQLite、Postgres、MySQL、Snowflake、BigQuery

适用场景

01询问数据库中的信息
02无需手写 SQL 即可运行查询

MCP 相关

向 MCP 客户端提供 `query` 工具，返回生成的 SQL、数据、错误和行数。可连接 Claude Desktop、Cursor、Goose 等兼容 MCP 的助手。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cpenniman12-text2sql": {
      "command": "uvx",
      "args": [
        "text2sql-mcp"
      ],
      "env": {
        "TEXT2SQL_DATABASE_URL": "<TEXT2SQL_DATABASE_URL>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "TEXT2SQL_MODEL": "<TEXT2SQL_MODEL>"
      }
    }
  }
}

启动命令uvx text2sql-mcp

需要配置的环境变量

TEXT2SQL_DATABASE_URLSQLAlchemy connection URL, e.g. sqlite:///mydb.db or postgresql://user:pass@host/db

ANTHROPIC_API_KEY密钥Anthropic API key (required if using the default Anthropic model)

OPENAI_API_KEY密钥OpenAI API key (required when TEXT2SQL_MODEL is set to an openai:* model)

TEXT2SQL_MODELOptional LangChain model id (default: anthropic:claude-sonnet-4-6)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypitext2sql-mcp0.1.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

text2sql-mcp

text2sql-framework 的 MCP 服务。可接入 Claude Desktop、Cursor、Goose 或其他兼容 MCP 的助手，让它通过自然语言查询 SQL 数据库。

Agent 会探索架构、编写 SQL、在实际数据库中执行，并在出错时自我修正——无需 RAG 层、架构描述或预先计算的嵌入。

安装

开箱即用，text2sql-mcp 支持 SQLite + Anthropic：

pip install text2sql-mcp
# or
uvx text2sql-mcp

对于其他数据库或大模型提供方，请安装对应的扩展，以安装正确的驱动：

你需要……	安装命令
SQLite（默认）	`uvx text2sql-mcp`
Postgres	`uvx 'text2sql-mcp[postgres]'`
MySQL	`uvx 'text2sql-mcp[mysql]'`
Snowflake	`uvx 'text2sql-mcp[snowflake]'`
BigQuery	`uvx 'text2sql-mcp[bigquery]'`
OpenAI 模型	添加 `openai`，例如 `uvx 'text2sql-mcp[postgres,openai]'`

配置

在 MCP 客户端配置中设置环境变量：

变量	必需	说明
`TEXT2SQL_DATABASE_URL`	是	SQLAlchemy URL，例如 `sqlite:///mydb.db`、`postgresql://user:pass@host/db`
`ANTHROPIC_API_KEY` 或 `OPENAI_API_KEY`	是	大模型提供方密钥
`TEXT2SQL_MODEL`	否	LangChain 模型 ID（默认值：`anthropic:claude-sonnet-4-6`）
`TEXT2SQL_INSTRUCTIONS`	否	业务规则 / 提示，例如 "Revenue = net of refunds."
`TEXT2SQL_EXAMPLES`	否	包含 Agent `lookup_example` 工具所用场景的 scenarios.md 文件路径

Claude Desktop / Cursor / 通用 MCP

{
  "mcpServers": {
    "text2sql": {
      "command": "uvx",
      "args": ["text2sql-mcp"],
      "env": {
        "TEXT2SQL_DATABASE_URL": "sqlite:///mydb.db",
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

Goose CLI

goose configure
# Add Extension → Command-line Extension
# Name: text2sql
# Command: uvx text2sql-mcp
# Env: TEXT2SQL_DATABASE_URL, ANTHROPIC_API_KEY

工具

query(question, max_rows=100) — 用自然语言向数据库提问。返回 {sql, data, error, row_count, tool_calls_made}。

工作原理

在底层，这是对 text2sql-framework 的轻量封装。该框架使用 LangChain Deep Agents，通过单个 execute_sql 工具进行迭代式工具调用。有关基准测试（在包含 80 张表的 Spider 零样本测试中达到 19/20）和架构详情，请参阅框架 README。