通过 SQLAlchemy 实现的 MCP 服务器 ODBC

一个轻量级的 MCP（模型上下文协议）服务器，用于 ODBC，使用 FastAPI、pyodbc 和 SQLAlchemy 构建。该服务器与 Virtuoso 数据库管理系统（DBMS）以及其他实现 SQL Alchemy 提供程序的后端数据库兼容。

功能

• 获取模式：抓取并列出数据库中的所有架构名称。
• 获取表：检索特定架构或所有架构的表信息。
• 描述表：生成表格结构的详细说明，包括：
  • 列名和数据类型
  • 可空属性
  • 主键和外键
• 搜索表：根据名称子字符串筛选并检索表。
• 执行存储过程：对于 Virtuoso，执行存储过程并获取结果。
• 执行查询：
  • JSONL 结果格式：优化用于结构化响应。
  • Markdown 表格格式：适合报告和可视化。

先决条件

1. 安装 uv：

   pip install uv
   

   或使用 Homebrew：

   brew install uv
   

2. unixODBC 运行时环境检查：

   1. 检查安装配置（例如，INI 文件的位置）：运行 odbcinst -j
   2. 列出可用的数据源名称：运行 odbcinst -q -s

3. ODBC 数据源名称设置：配置您的 ODBC 数据源名称 (~/.odbc.ini) 以匹配目标数据库。Virtuoso 示例：

   [odbc]
   Driver = Virtuoso ODBC Driver
   ServerName = localhost:8889
   DatabaseName = db_name
   Username = user_name
   Password = user_password
   

4. SQLAlchemy 和 Python ODBC 库：

   pip install sqlalchemy pyodbc
   

安装

1. 克隆代码库到本地目录：

   git clone https://github.com/your-username/mcp-server.git
   cd mcp-server
   

2. 更新 config.py 文件以匹配您的数据库设置。

3. 运行服务器：

   uvicorn main:app --reload
   

配置

1. 更新环境变量：在根目录中创建或编辑 .env 文件，添加以下内容：

   DATABASE_URL=odbc://username:password@localhost:8889/db_name
   

2. Claude Desktop 用户配置示例：

   npx @modelcontextprotocol/core --directory . run mcp-server
   

使用说明

数据库连接 URL 格式

下表列出了支持的数据库及其对应的 ODBC 连接字符串格式：

工具

以下是可用工具的描述：

• virtuosoSupportAI：与 Virtuoso 支持助理/代理交互，这是 Virtuoso 的特定功能，用于与大语言模型（LLM）互动。

故障排除

为方便故障排除：

1. 安装 MCP 检查器：

   npm install -g @modelcontextprotocol/inspector
   

2. 启动检查器：

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

访问提供的 URL 以排除服务器交互问题。