MCP Server ODBC via SQLAlchemy

MCP Server ODBC via SQLAlchemy

使用 FastAPI、ODBC 和 SQLAlchemy 的简单 MCP ODBC 服务器。

GitHub
Created ByOpenLinkSoftwareOpenLinkSoftware

MCP ODBC 服务器 Quick Start 指南

概述

这是一个使用 FastAPI、pyodbc 和 SQLAlchemy 构建的轻量级 MCP (模型上下文协议) ODBC 服务器，支持 Virtuoso DBMS 和其他 SQLAlchemy 兼容数据库。

前提条件

  1. 安装 uv:
pip install uv
# 或
brew install uv
  1. 配置 ODBC DSN (~/.odbc.ini):
[VOS]
Description = OpenLink Virtuoso
Driver = /path/to/virtodbcu_r.so
Database = Demo
Address = localhost:1111
WideAsUTF16 = Yes

安装与配置

  1. 克隆仓库:
git clone https://github.com/OpenLinkSoftware/mcp-server-odbc.git
  1. Claude Desktop 配置 (claude_desktop_config.json):
{
  "mcpServers": {
    "my_database": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server-odbc", "run", "mcp-server-odbc"],
      "env": {
        "DB_URL": "virtuoso+pyodbc://user:password@VOS"
      }
    }
  }
}

数据库连接 URL 示例

数据库URL 格式
Virtuoso DBMSvirtuoso+pyodbc://user:password@ODBC_DSN
PostgreSQLpostgresql://user:password@localhost/dbname
MySQLmysql+pymysql://user:password@localhost/dbname
SQLitesqlite:///path/to/database.db

主要功能

  • 获取数据库模式
  • 获取和搜索表
  • 描述表结构（列、数据类型、键关系）
  • 执行存储过程
  • 执行查询（支持 JSONL 和 Markdown 输出格式）

调试

安装 MCP 检查器:

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-odbc run mcp-server-odbc

然后访问提供的 URL 进行交互调试。