Pyodbc

🚀 MCP 协议 Python ODBC 服务器

MCP 协议 Python ODBC 服务器提供了与数据库交互的功能，支持标准 SQL 查询、SPARQL 查询以及 Virtuoso 特定功能，方便开发者进行数据库操作。

🚀 快速开始

你可以按照以下步骤快速启动 MCP 协议 Python ODBC 服务器。

📦 安装指南

通过 pip 安装

使用以下命令通过 pip 安装：

pip install mcp-pyodbc-server

手动安装

1. 下载源代码并解压：

   git clone https://github.com/yourusername/mcp-pyodbc-server.git
   cd mcp-pyodbc-server
   

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 运行服务器：

   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 以进行服务器交互故障排除。