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

💻 使用例

基本的な使用法

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);
});

返却形式

• JSON：標準のJSON配列で、ほとんどのケースに適しています。
• JSONL：1行に1つのJSONオブジェクトで、大量のデータ出力に適しています。
• Markdownテーブル：Markdown形式でテーブルデータを返し、ドキュメント表示に便利です。

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);
});

✨ 主な機能

サポートされるデータベースシステム

• MySQL
• PostgreSQL
• SQLite
• MSSQL
• Oracle

特徴

• 複数の接続プロトコルをサポート
• データベースの自動再接続
• クエリ結果のフォーマット（JSON、JSONL、Markdownテーブル）
• ストアドプロシージャの呼び出しをサポート（特定のデータベースのみ）

🔧 トラブルシューティング

トラブルシューティングをより簡単に行うには、以下の手順を実行します。

1. MCPチェックツールをインストールします。

   npm install -g @modelcontextprotocol/inspector
   

2. チェックツールを起動します。

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

提供されたURLにアクセスして、サーバーとのやり取りのトラブルシューティングを行います。