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 以排除服務器交互問題。