MCP Odbc

🚀 ODBC MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いたサーバーで、Claude Desktop などの LLM ツールが ODBC 接続を通じてデータベースを照会できるようにします。Claude やその他の MCP クライアントが、データベースのデータにアクセス、分析し、洞察を生成できる一方で、安全性と読み取り専用保護を維持します。

✨ 主な機能

• 任意の ODBC 互換データベースに接続可能
• 複数のデータベース接続をサポート
• 設定ファイルまたは Claude Desktop の設定による柔軟な構成
• データの変更を防止する読み取り専用保護
• UV パッケージマネージャーを使用した簡単なインストール
• 詳細なエラーレポートとログ記録

📦 インストール

前提条件

• Python 3.10 以上
• UV パッケージマネージャー
• システムにインストールされた ODBC ドライバー（対象データベース用）
• Sage 100 Advanced の場合：ProvideX ODBC ドライバーを用意する

インストール手順

git clone https://github.com/tylerstoltz/mcp-odbc.git
cd mcp-odbc
uv venv
.venv\Scripts\activate # Mac/Linux の場合：source .venv/bin/activate (未検証)
uv pip install -e .

📚 ドキュメント

設定方法

サーバーは以下の方法で設定できます。

1. 専用の設定ファイル
2. 環境変数
3. Claude Desktop の設定

一般的な設定

データベース接続の詳細を含む設定ファイル（.ini）を作成します。

[SERVER]
default_connection = my_database
max_rows = 1000
timeout = 30

[my_database]
dsn = MyDatabaseDSN
username = your_username
password = your_password
readonly = true

SQLite の設定

ODBC を使用する SQLite データベースの場合：

[SERVER]
default_connection = sqlite_db
max_rows = 1000
timeout = 30

[sqlite_db]
dsn = SQLite_DSN_Name
readonly = true

Sage 100 ProvideX の設定

ProvideX は互換性を実現するために特殊な設定が必要です。以下の最小限の設定を使用すると最適な結果が得られます。

[SERVER]
default_connection = sage100
max_rows = 1000
timeout = 60

[sage100]
dsn = YOUR_PROVIDEX_DSN
username = your_username
password = your_password
company = YOUR_COMPANY_CODE
readonly = true

ProvideX の重要な注意事項：

• 最小限の設定を使用する - 他のパラメータを追加すると接続問題が発生する可能性があります
• 常に readonly = true を設定して安全性を確保する
• Company パラメータが正しいことを確認する
• 特殊な ProvideX 設定テンプレートを使用する

Claude Desktop の設定

{
    "odbc_config": {
        "driver": "ODBC Driver Name",
        "connection_string": "DSN=MyDatabaseDSN;UID=my_username;PWD=my_password"
    }
}

📄 ライセンス

MIT ライセンス - 著作権 (c) 2024