ODBC MCP 服务器

一个 Model Context Protocol (MCP) 服务器，使 LLM 工具（如 Claude Desktop）能够通过 ODBC 连接查询数据库。该服务器允许 Claude 和其他 MCP 客户端访问、分析并从数据库数据中生成见解，同时保持安全性和只读保护。

特性

• 连接到任何 ODBC 兼容的数据库
• 支持多个数据库连接
• 通过配置文件或 Claude Desktop 设置实现灵活配置
• 只读保护以防止数据修改
• 使用 UV 包管理器轻松安装
• 详细的错误报告和日志记录

prerequisites

• 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

ProvideX 的重要注意事项：

• 使用最小配置 - 添加其他参数可能会导致连接问题
• 总是设置 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