ODBC MCP Server

ODBC MCP Server

site icon
2025.03.21 0
Python数据库连接数据分析数据查询数据库
ODBC MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,它允许像 Claude Desktop 这样的 LLM 工具通过 ODBC 连接查询数据库。该服务使 Claude 和其他 MCP 客户端能够访问、分析数据库数据并从中生成见解,同时保持安全性和只读保护。
View on GitHub

Overview

基本能力

产品定位

ODBC MCP Server 是一个数据库连接服务,旨在为 LLM 工具提供安全、只读的数据库访问能力。

核心功能

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

适用场景

  • 需要让 LLM 工具访问数据库进行分析的场景
  • 需要安全、只读地访问数据库的场景
  • 需要从多个数据库获取数据的场景

工具列表

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

常见问题解答

  • 连接问题: 检查 ODBC 驱动是否正确安装,测试 DSN 是否正常工作
  • ProvideX 特定问题: 使用最小连接配置,确保公司参数正确
  • 缺少表: 验证用户权限,检查公司代码是否正确

使用教程

使用依赖

  • 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 # On Mac / Linux: source .venv/bin/activate (untested)
uv pip install -e .

调试方式

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

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。