MCP Pyodbc Server

🚀 MCP プロトコル ODBC サーバープラグイン

このプロジェクトは、MCP プロトコルに基づく汎用的な ODBC データベースコネクタです。ODBC ドライバーを通じて様々なデータベースに接続することができます。

🚀 クイックスタート

1. MCP サービスの初期化

from mcp import Service, BinaryFileStorage
import logging

# ログの設定
logging.basicConfig(level=logging.INFO)

# サービスインスタンスの作成
service = Service(
    storage=BinaryFileStorage('data/'),  # データ保存ディレクトリ
    name='ODBC Server',                  # サービス名
    description='An ODBC server based on MCP protocol'  # サービスの説明
)

2. データベース接続設定の定義

from mcp.config import ODBCConfig

# ODBC 設定の作成
config = ODBCConfig(
    driver='path/to/your/driver',  # ODBC ドライバーのパス
    connection_string='DRIVER={Your Driver};DATABASE={Your Database}',  # 接続文字列
    username='your_username',       # データベースのユーザー名
    password='your_password'        # データベースのパスワード
)

3. MCP サービスの起動

# ODBC プラグインを追加してサービスを起動
service.add_plugin('ODBC', config)
service.start()

# Ctrl+C を押してサービスを停止

✨ 主な機能

このプラグインは、以下の主要な機能を提供します：

• MCP プロトコルを使用した汎用的な ODBC データベース接続
• 複数のデータベースへの接続サポート

📦 インストール

pip を使用したインストール

pip install mcp-odbc

ソースコードからのインストール

デバッグや開発が必要な場合は、リポジトリをクローンしてソースコードからインストールできます。

git clone https://github.com/your-repository/mcp-odbc.git
cd mcp-odbc
pip install -e .

💻 使用例

基本的な使用法

MCP サービスの初期化

from mcp import Service, BinaryFileStorage
import logging

# ログの設定
logging.basicConfig(level=logging.INFO)

# サービスインスタンスの作成
service = Service(
    storage=BinaryFileStorage('data/'),  # データ保存ディレクトリ
    name='ODBC Server',                  # サービス名
    description='An ODBC server based on MCP protocol'  # サービスの説明
)

ODBC プラグインの追加

from mcp.plugins import add_odbc_plugin

# ODBC 接続パラメータの設定
odbc_config = {
    'driver': 'path/to/your/driver',  # ODBC ドライバーのパス
    'connection_string': 'DRIVER={Your Driver};DATABASE={Your Database}',  # 接続文字列
    'username': 'your_username',       # データベースのユーザー名
    'password': 'your_password'        # データベースのパスワード
}

# ODBC プラグインの追加
add_odbc_plugin(service, odbc_config)

サービスの起動

import uvicorn

# サービスの起動
uvicorn.run('mcp_server:app', reload=True)

高度な使用法

サンプルサービスの実行

以下のコマンドを実行してサンプルサービスを起動します。

uvicorn mcp_server:app --reload

その後、ブラウザで http://localhost:8000 にアクセスして管理コンソールを開きます。

サポートされるインターフェース

• /api/v1/login - ログイン認証
• /api/v1/users - ユーザー管理
• /api/v1/databases - データベース管理
• /api/v1/models - モデル管理
• /api/v1/files - ファイル管理

📚 ドキュメント

依存関係

• Python - バージョン要件: 3.6+
• pip - パッケージ管理ツール
• ODBC ドライバー - 対象データベースに応じて異なります

文献

• [1] MCP プロトコル仕様
• [2] ODBC ドライバー開発ガイド