OMNI-MS-Access-MCP

🚀 MS 访问 MCP 探索器

这是一个借助 MCP（模型 - 命令 - 过程）来探索和查询 Microsoft Access 数据库的实用工具，能让你更便捷地操作数据库。

🚀 快速开始

📦 安装指南

你可以选择以下两种方式进行安装：

• 使用 UV 安装：

uv pip install omni-ms-access-mcp

• 使用 pip 安装：

pip install omni-ms-access-mcp

💻 使用示例

基础用法

• 命令行方式：通过指定的路径启动 MCP 服务器。

ms-access-mcp --db-path "C:\path\to\your\database.accdb"

• Python API 方式：

from omni_ms_access_mcp.server import AccessMCP

# 初始化 MCP 服务器
mcp_server = AccessMCP(db_path="C:/path/to/your/database.accdb")

# 运行服务器
mcp_server.run()

可用工具介绍

1. get_schema_tool - 获取数据库模式信息
   • 可选参数：format - 可以是 "text"（默认）或 "json"
   • 示例：get_schema_tool(format="json")
2. query_data - 对数据库执行 SQL 查询
   • 必需参数：sql - 要执行的 SQL 查询
   • 示例：query_data(sql="SELECT * FROM Users LIMIT 10")

🔧 开发相关

设置开发环境

uv venv
.venv\Scripts\activate.bat
uv pip install -e .

打包

publish.bat

发布到软件包索引

uv pip install -U twine
uv python -m twine upload dist/*

⚠️ 重要提示

• 系统上必须安装 Microsoft Access 驾驶员。
• 请使用 Python 3.7 或更高版本。