MCP Odbc

🚀 ODBC MCP 服務器

ODBC MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它能讓 LLM 工具（如 Claude Desktop）通過 ODBC 連接來查詢數據庫。藉助該服務器，Claude 及其他 MCP 客戶端可以安全地訪問、分析數據庫數據並生成見解，同時具備只讀保護功能，確保數據安全。

🚀 快速開始

ODBC MCP 服務器允許 Claude 和其他 MCP 客戶端通過 ODBC 連接查詢數據庫。要使用該服務器，你需要滿足一些前提條件並完成安裝和配置。

✨ 主要特性

• 可連接到任何 ODBC 兼容的數據庫。
• 支持多個數據庫連接。
• 可通過配置文件、環境變量或 Claude Desktop 設置實現靈活配置。
• 具備只讀保護，防止數據被修改。
• 可使用 UV 包管理器輕鬆完成安裝。
• 提供詳細的錯誤報告和日誌記錄。

📦 安裝指南

前提條件

• Python 3.10 或更高版本。
• UV 包管理器。
• 系統上已安裝針對目標數據庫的 ODBC 驅動程序。
• 對於 Sage 100 Advanced，需提供 ProvideX ODBC 驅動程序。

安裝步驟

git clone https://github.com/tylerstoltz/mcp-odbc.git
cd mcp-odbc
uv venv
.venv\Scripts\activate # 在 Mac/Linux 上：source .venv/bin/activate (未經測試)
uv pip install -e .

📚 詳細文檔

配置方式

服務器可通過以下三種方式進行配置：

1. 專用的配置文件。
2. 環境變量。
3. Claude Desktop 設置。

通用配置設置

創建包含數據庫連接詳細信息的配置文件（.ini）：

[SERVER]
default_connection = my_database
max_rows = 1000
timeout = 30

[my_database]
dsn = MyDatabaseDSN
username = your_username
password = your_password
readonly = true

SQLite 配置

對於使用 ODBC 的 SQLite 數據庫：

[SERVER]
default_connection = sqlite_db
max_rows = 1000
timeout = 30

[sqlite_db]
dsn = SQLite_DSN_Name
readonly = true

Sage 100 ProvideX 配置

ProvideX 需要特殊配置以實現兼容性。使用以下最小配置以獲得最佳效果：

[SERVER]
default_connection = sage100
max_rows = 1000
timeout = 60

[sage100]
dsn = YOUR_PROVIDEX_DSN
username = your_username
password = your_password
company = YOUR_COMPANY_CODE
readonly = true

⚠️ 重要提示

• 使用最小配置 - 添加其他參數可能會導致連接問題。
• 總是設置 readonly = true 以確保安全。
• 確保 Company 參數正確。
• 使用特殊的 ProvideX 配置模板。

Claude Desktop 設置

{
    "odbc_config": {
        "driver": "ODBC Driver Name",
        "connection_string": "DSN=MyDatabaseDSN;UID=my_username;PWD=my_password"
    }
}

📄 許可證

本項目採用 MIT 許可證 - 版權所有 (c) 2024。