My Database

🚀 MCP 萬用數據庫連接協議 sqlalchemy 服務器

MCP 萬用數據庫連接協議 sqlalchemy 服務器是一個基於 SQLAlchemy 的通用數據庫連接服務器，支持多種數據庫系統，能為開發者提供便捷、高效的數據庫連接解決方案。

🚀 快速開始

安裝

pip install mcp-sqlalchemy-server

配置

編輯配置文件 config.json：

{
  "port": 5001,
  "databases": {
    "mysql": {
      "driver": "mysql+pymysql",
      "host": "localhost",
      "database": "mydb",
      "user": "root",
      "password": "password"
    },
    "postgresql": {
      "driver": "postgresql+psycopg2",
      "host": "localhost",
      "database": "mydb",
      "user": "postgres",
      "password": "password"
    }
  }
}

啟動

python -m mcp_sqlalchemy_server --config config.json

✨ 主要特性

支持的數據庫系統

• MySQL
• PostgreSQL
• SQLite
• MSSQL
• Oracle

特性

• 支持多種連接協議
• 數據庫自動重連
• 查詢結果格式化（JSON, JSONL, Markdown 表格）
• 支持存儲過程調用（僅限特定數據庫）

📦 安裝指南

安裝

pip install mcp-sqlalchemy-server

配置

編輯配置文件 config.json：

{
  "port": 5001,
  "databases": {
    "mysql": {
      "driver": "mysql+pymysql",
      "host": "localhost",
      "database": "mydb",
      "user": "root",
      "password": "password"
    },
    "postgresql": {
      "driver": "postgresql+psycopg2",
      "host": "localhost",
      "database": "mydb",
      "user": "postgres",
      "password": "password"
    }
  }
}

啟動

python -m mcp_sqlalchemy_server --config config.json

💻 使用示例

基礎用法

const MCP = require('mcp-sqlalchemy-client');

// 連接到 MySQL 數據庫
const mysqlConn = new MCP.Connection({
  database: 'mysql',
  user: 'root',
  password: 'password'
});

// 執行查詢
mysqlConn.query('SELECT * FROM users').then(rows => {
  console.log(rows);
}).catch(err => {
  console.error(err);
});

// 連接到 PostgreSQL 數據庫
const postgresConn = new MCP.Connection({
  database: 'postgresql',
  user: 'postgres',
  password: 'password'
});

// 執行查詢
postgresConn.query('SELECT * FROM users').then(rows => {
  console.log(rows);
}).catch(err => {
  console.error(err);
});

高級用法

執行 SQL 查詢

const query = 'SELECT * FROM users WHERE id = 1';
conn.query(query).then(rows => {
  console.log(rows);
}).catch(err => {
  console.error(err);
});

特殊功能（僅限 Virtuoso）

執行 SPASQL 查詢

const query = 'EXEC Demo.demo.execute_spasql_query';
conn.spasql(query).then(rows => {
  console.log(rows);
}).catch(err => {
  console.error(err);
});

執行 SPARQL 查詢

const query = 'SELECT * { <http://example.org> <p:age> ?age}';
conn.sparql(query).then(rows => {
  console.log(rows);
}).catch(err => {
  console.error(err);
});

調用 Virtuoso AI 助手

const prompt = '告訴我一些關於數據庫優化的建議。';
conn.virtuosoSupportAI(prompt).then(response => {
  console.log(response);
}).catch(err => {
  console.error(err);
});

📚 詳細文檔

返回格式

• JSON：標準 JSON 數組，適合大多數情況。
• JSONL：每行一個 JSON 對象，適合大數據量輸出。
• Markdown 表格：以 Markdown 格式返回表格數據，方便文檔展示。

🔧 技術細節

故障排除

為了更方便地進行故障排除：

1. 安裝 MCP 檢查工具：

   npm install -g @modelcontextprotocol/inspector
   

2. 啟動檢查工具：

   npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-sqlalchemy-server run mcp-sqlalchemy-server
   

訪問提供的 URL 進行服務器交互故障排除。