MCP ODBC 服务器

MCP ODBC 服务器

一个使用 FastAPI、ODBC 和 SQLAlchemy 的轻量级 MCP 协议服务器,兼容 Virtuoso 等数据库。

快速入门

  1. 安装 uv
    pip install uv
    
    或通过 Homebrew 安装:
    brew install uv
    
  2. 配置 ODBC 数据源: 在 ~/.odbc.ini 文件中添加数据源配置,例如:
    [VOS]
    Description = OpenLink Virtuoso
    Driver = /path/to/virtodbcu_r.so
    Database = Demo
    Address = localhost:1111
    WideAsUTF16 = Yes
    
  3. 克隆仓库并设置环境变量
    git clone https://github.com/OpenLinkSoftware/mcp-sqlalchemy-server.git
    cd mcp-sqlalchemy-server
    
    创建 .env 文件并设置以下内容:
    ODBC_DSN=VOS
    ODBC_USER=dba
    ODBC_PASSWORD=dba
    API_KEY=xxx
    
  4. 运行服务: 使用以下命令启动服务器:
    uv run mcp-sqlalchemy-server
    
  5. 验证功能:访问工具提供的 API 路径,如 /podbc_get_schemas 获取数据库模式列表。
  6. 调试(可选):安装 MCP Inspector 工具进行交互式调试:
    npm install -g @modelcontextprotocol/inspector
    npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server