返回 MCP 目录
public公开dns本地运行

SQLAlchemy ODBC Bridge

一个基于FastAPI、pyodbc和SQLAlchemy的轻量级MCP服务器,支持通过ODBC连接多种数据库(如Virtuoso、PostgreSQL等),提供数据库模式查询、表结构描述、SQL执行等功能,并支持JSONL和Markdown格式的结果返回。

article

README

🚀 MCP sqlalchemy 服务器

MCP sqlalchemy 服务器是一个实用的工具,它能帮助开发者快速搭建数据库服务,支持多种数据库系统,还可通过插件扩展功能。

🚀 快速开始

要快速上手使用 MCP sqlalchemy 服务器,可按以下步骤操作:

安装依赖

首先,安装所需的依赖项:

pip install mcp-sqlalchemy-server

启动服务器

使用以下命令启动服务器:

python -m mcp_sqlalchemy_server.server start --host 127.0.0.1 --port 5000

这将启动一个 MCP sqlalchemy 服务器,监听地址为 127.0.0.1,端口为 5000

访问 API

服务器成功启动后,你可以通过以下 URL 访问其提供的 API:

http://localhost:5000/swagger-ui.html

📚 详细文档

数据库支持

MCP sqlalchemy 服务器目前支持以下数据库系统:

  • SQLite
  • MySQL
  • PostgreSQL 具体的数据库连接配置,请参考项目文档中的数据库连接部分。

💻 使用示例

基础用法

以下是使用 MCP sqlalchemy 服务器的简单示例:

# 安装依赖
pip install mcp-sqlalchemy-server
# 启动服务器
from mcp_sqlalchemy_server import create_app

app = create_app()
if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000)

启动后,访问 http://localhost:5000/swagger-ui.html 即可查看可用的 API 接口。

配置选项

MCP sqlalchemy 服务器提供了丰富的配置选项:

数据库连接

class Config:
    SQLALCHEMY_DATABASE_URI = "sqlite:///test.db"
    SQLALCHEMY_TRACK_MODIFICATIONS = False

日志设置

LOG_LEVEL = "INFO"
LOG_FILE = "mcp-sqlalchemy-server.log"

扩展插件

MCP sqlalchemy 服务器支持以下扩展插件:

  • Plugin1:描述插件的功能和用途。
  • Plugin2:描述插件的功能和用途。 具体的插件开发实现,请参考项目文档中的插件开发部分。

故障排除

安装 MCP Inspector

为了便于故障排除,你可以安装 MCP Inspector:

npm install -g @modelcontextprotocol/inspector

启动 Inspector

使用以下命令启动 Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server

启动后,访问提供的 URL 即可进行故障排除。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端