Openlinksoftware MCP Sqlalchemy Server

🚀 通过 SQLAlchemy 实现的 MCP 服务器 ODBC

这是一个轻量级的 MCP（模型上下文协议）服务器，专为 ODBC 打造。它基于 FastAPI、pyodbc 和 SQLAlchemy 构建，不仅能与 Virtuoso 数据库管理系统（DBMS）完美兼容，还支持其他实现 SQL Alchemy 提供程序的后端数据库。

🚀 快速开始

本项目是一个轻量级的 MCP 服务器，借助 FastAPI、pyodbc 和 SQLAlchemy 构建，可与多种数据库兼容。下面将为你详细介绍如何使用它。

✨ 主要特性

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

📦 安装指南

先决条件

1. 安装 uv：

   pip install uv
   

   或使用 Homebrew：

   brew install uv
   

2. unixODBC 运行时环境检查：
   • 检查安装配置（例如，INI 文件的位置）：运行 odbcinst -j
   • 列出可用的数据源名称：运行 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 格式

工具

• 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 以排除服务器交互问题。