🚀 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。