🚀 MCP 协议 Python ODBC 服务器
MCP 协议 Python ODBC 服务器提供了与数据库交互的功能，支持标准 SQL 查询、SPARQL 查询以及 Virtuoso 特定功能，方便开发者进行数据库操作。
🚀 快速开始
你可以按照以下步骤快速启动 MCP 协议 Python ODBC 服务器。
📦 安装指南
通过 pip 安装
使用以下命令通过 pip 安装：
pip install mcp-pyodbc-server
手动安装
-
下载源代码并解压：
git clone https://github.com/yourusername/mcp-pyodbc-server.git cd mcp-pyodbc-server -
安装依赖项：
pip install -r requirements.txt -
运行服务器：
python -m mcp_pyodbc_server.server
🛠️ 配置指南
环境变量配置
设置以下环境变量以自定义服务器行为：
MCP_SERVER_HOST：指定服务器绑定的主机地址，默认为localhost。MCP_SERVER_PORT：指定服务器监听的端口，默认为8000。MCP_SERVER_DEBUG：启用调试模式，设置为True或False，默认为False。
配置文件
创建一个名为 config.json 的文件，并在其中添加以下配置：
{
"host": "localhost",
"port": 8000,
"debug": false
}
✨ 主要特性
MCP 协议 Python ODBC 服务器提供了一系列用于与数据库交互的功能，包括标准 SQL 查询、SPARQL 查询以及 Virtuoso 特定功能。以下是主要功能的详细说明：
标准 SQL 查询
- podbc_query_database：执行标准 SQL 查询并返回结果。
- podbc_query_database_md：执行标准 SQL 查询并返回 Markdown 表格格式的结果。
- podbc_query_database_jsonl：执行标准 SQL 查询并返回 JSON Lines (JSONL) 格式的结果。
SPARQL 查询
- podbc_sparql_query：执行 SPARQL 查询并返回结果。支持指定结果格式和超时设置。
Virtuoso 特定功能
- podbc_spasql_query：执行 SPASQL（SQL/SPARQL 混合）查询并返回结果。
- podbc_virtuoso_support_ai：利用 Virtuoso 的 AI 支持函数，通过提示和可选 API 键来获取结果。
💻 使用示例
基础用法
执行标准 SQL 查询
import mcp_pyodbc_server as mcp
# 执行查询
result = mcp.pdbc_query_database(query="SELECT * FROM your_table", dsn="YourDSN")
# 打印结果
print(result)
执行 SPARQL 查询
import mcp_pyodbc_server as mcp
# 执行 SPARQL 查询
result = mcp.pdbc_sparql_query(query="SELECT * FROM your_graph WHERE ?x ?y ?z", dsn="YourDSN")
# 打印结果
print(result)
使用 Virtuoso AI 支持功能
import mcp_pyodbc_server as mcp
# 调用 AI 支持函数
result = mcp.pdbc_virtuoso_support_ai(prompt="你的提示文本", api_key="your_api_key", dsn="YourDSN")
# 打印结果
print(result)
🛠️ 故障排除
安装 MCP 监视器
npm install -g @modelcontextprotocol/inspector
启动监视器
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-pyodbc-server run mcp-pyodbc-server
访问提供的 URL 以进行服务器交互故障排除。