Database MCP Server (by Legion AI)

基本能力

产品定位

Legion MCP Server 是一个数据库访问和查询服务，旨在通过 MCP 协议为 AI 助手和数据分析工具提供数据库操作能力。

核心功能

• 通过 Legion Query Runner 访问和查询数据库
• 支持 Model Context Protocol (MCP) 用于 AI 助手
• 将数据库操作暴露为 MCP 资源、工具和提示
• 多种部署选项（独立 MCP 服务器、FastAPI 集成）
• 查询执行和结果处理
• 通过环境变量、命令行参数或 MCP 设置 JSON 进行灵活配置

适用场景

• AI 助手需要访问数据库的场景
• 数据分析工具需要执行 SQL 查询的场景
• 需要将数据库操作集成到 MCP 生态系统中的场景

工具列表

• execute_query: 执行 SQL 查询并返回结果作为 Markdown 表格
• execute_query_json: 执行 SQL 查询并返回结果作为 JSON
• get_table_columns: 获取特定表的列名
• get_table_types: 获取特定表的列类型
• get_query_history: 获取最近的查询历史

常见问题解答

• 如何配置数据库连接？通过 DB_TYPE 和 DB_CONFIG 环境变量或命令行参数配置。
• 支持哪些数据库？支持 PostgreSQL、Redshift、CockroachDB、MySQL、Microsoft SQL Server、Big Query、Oracle DB 和 SQLite。

使用教程

使用依赖

需要安装 Python 和 Legion Query Runner 库。

安装教程

使用 PIP 安装

pip install database-mcp

使用 UV 安装

{
    "mcpServers": {
      "database-mcp": {
        "command": "uvx",
        "args": [
          "database-mcp"
        ],
        "env": {
          "DB_TYPE": "pg",
          "DB_CONFIG": "{\"host\":\"localhost\",\"port\":5432,\"user\":\"user\",\"password\":\"pw\",\"dbname\":\"dbname\"}"
        },
        "disabled": true,
        "autoApprove": []
      }
    }
}

调试方式

开发模式

mcp dev mcp_server.py

生产模式

python mcp_server.py

环境变量配置

export DB_TYPE="pg"
export DB_CONFIG='{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'
mcp dev mcp_server.py

命令行参数配置

python mcp_server.py --db-type pg --db-config '{"host":"localhost","port":5432,"user":"username","password":"password","dbname":"database_name"}'

许可证

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