ODBC MCP 服务器

一个 MCP (模型上下文协议) 服务器，使像 Claude Desktop 这样的 LLM 工具能够通过 ODBC 连接查询数据库。此服务器允许 Claude 和其他 MCP 客户端访问、分析数据库数据并从中生成见解，同时保持安全性和只读保护。

特性

• 连接到任何 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

ProvideX 的重要说明：

• 使用最小配置 - 添加额外的参数可能会导致连接问题
• 始终设置 readonly = true 以确保安全
• company 参数是 Sage 100 连接所必需的
• 避免在建立连接后更改连接属性

Claude Desktop 集成

要在 Claude Desktop 中配置服务器：

1. 打开或创建 claude_desktop_config.json：

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加 MCP 服务器配置：

{
  "mcpServers": {
    "odbc": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\mcp-odbc",
        "run",
        "odbc-mcp-server",
        "--config", 
        "C:\\path\\to\\mcp-odbc\\config\\your_config.ini"
      ]
    }
  }
}

用法

手动启动服务器

# 使用默认配置启动
odbc-mcp-server

# 使用特定的配置文件启动
odbc-mcp-server --config path/to/config.ini

与 Claude Desktop 一起使用

1. 如上所示，在 Claude Desktop 的配置文件中配置服务器
2. 重启 Claude Desktop
3. ODBC 工具将自动出现在 MCP 工具列表中

可用的 MCP 工具

ODBC MCP 服务器提供以下工具：

1. list-connections: 列出所有配置的数据库连接
2. list-available-dsns: 列出系统上所有可用的 DSN
3. test-connection: 测试数据库连接并返回信息
4. list-tables: 列出数据库中的所有表
5. get-table-schema: 获取表的模式信息
6. execute-query: 执行 SQL 查询并返回结果

示例查询

在连接服务器后，在 Claude Desktop 中尝试以下提示：

• "Show me all the tables in the database" (显示数据库中的所有表)
• "What's the schema of the Customer table?" (Customer 表的模式是什么？)
• "Run a query to get the first 10 customers" (运行查询以获取前 10 个客户)
• "Find all orders placed in the last 30 days" (查找过去 30 天内的所有订单)
• "Analyze the sales data by region and provide insights" (按地区分析销售数据并提供见解)

故障排除

连接问题

如果遇到连接问题：

1. 验证您的 ODBC 驱动程序是否已正确安装
2. 使用 ODBC 数据源管理器测试您的 DSN
3. 检查配置文件中的连接参数
4. 在 Claude Desktop 日志中查找详细的错误消息

ProvideX 特定问题

对于 Sage 100/ProvideX：

1. 使用最小连接配置（DSN、用户名、密码、公司）
2. 确保公司参数正确
3. 使用特殊的 ProvideX 配置模板
4. 如果遇到 Driver not capable 错误，请检查是否在连接时设置了自动提交

缺少表

如果表未显示：

1. 验证数据库帐户的用户权限
2. 检查公司代码是否正确（对于 Sage 100）
3. 尝试使用完全限定的表名 (schema.table)

许可证

MIT 许可证 - 版权所有 (c) 2024