RIB iTWO 4.0 MCP Server

RIB iTWO 4.0 インスタンスの SQL Server データベースにアクセスするための読み取り専用 MCP サーバー。

Tools

• list_schemas – すべてのスキーマを一覧表示

• list_tables(schema) – スキーマのテーブル/ビューを一覧表示

• search_tables(keyword) – すべてのスキーマにわたってテーブルを名前で検索

• describe_table(schema, table) – 列、型、NULL許容性を表示

• run_query(sql) – 任意の SELECT ステートメントを実行（読み取り専用に強制）

Related MCP server: mcp-sqlserver-readonly

Setup

1. ODBC ドライバーのインストール: Microsoft ODBC Driver 18 for SQL Server を Windows にインストールします。

2. DB ユーザーの作成: SQL Server 上に、iTWO データベース用の db_datareader ロール（読み取り専用）を持つログインを作成します。サーバー側の権限が本来の保護であり、サーバー内のクエリフィルタリングは追加の保護層にすぎません。

3. 依存関係のインストール:

   cd "C:\Users\schol\Desktop\MCP Datenbank"
   python -m venv .venv
   .venv\Scripts\Activate.ps1
   pip install -e .

4. 設定: .env.example を .env にコピーし、接続情報を記入します。

   Copy-Item .env.example .env

5. ローカルでのテスト:

   python -m rib_itwo_mcp.server

Coolify へのデプロイ

このサーバーは HTTP サービス（トランスポート streamable-http）として動作し、Claude がリモートで接続できるようにします。ODBC ドライバーは Dockerfile に含まれているため、Coolify ホスト自体に DB クライアントをインストールする必要はありません。

1. リポジトリを Git にプッシュします（GitHub/GitLab など）。

2. Coolify でこのリポジトリから新しい Application を作成します。ビルドパック: Dockerfile。

3. Coolify で環境変数を設定します（.env.example より）:

   • DB_SERVER, DB_NAME, DB_USER, DB_PASSWORD

   • DB_DRIVER=ODBC Driver 18 for SQL Server

   • DB_TRUST_SERVER_CERTIFICATE=yes（有効な証明書がある場合は no）

   • DB_ALLOWED_SCHEMAS, DB_MAX_ROWS はオプション

   • MCP_AUTH_TOKEN — 必須。長いランダムなシークレット（openssl rand -hex 32）。設定しない場合、エンドポイントがネットワーク上に公開されたままになるため。

4. ポート 8000 を開放するか、Coolify プロキシ/ドメインをそのポートにマッピングします。ヘルスチェックパスは /health です。

5. デプロイします。SQL Server には Coolify ホストからネットワーク経由で到達できる必要があります（必要に応じてファイアウォール/セキュリティグループを調整し、ポート 1433 を開放します）。

Claude にコネクタとして追加する（リモート/HTTP）

アプリが、例えば https://rib-itwo-mcp.deine-domain.de でアクセス可能になったら:

claude mcp add --transport http rib-itwo https://rib-itwo-mcp.deine-domain.de/mcp --header "Authorization: Bearer <dein-MCP_AUTH_TOKEN>"

（Claude Desktop/Web のインターフェースで、URL と Bearer トークンを指定して「Custom Connector」として登録します。）

ローカルで stdio コネクタとして使用する（Coolify なしの代替）

HTTP を使わず、完全にローカルでの利用のみを行う場合、MCP_TRANSPORT=stdio を設定できます:

claude mcp add rib-itwo -e MCP_TRANSPORT=stdio -- "C:\Users\schol\Desktop\MCP Datenbank\.venv\Scripts\python.exe" -m rib_itwo_mcp.server

セキュリティ

• run_query は単一の SELECT/WITH ステートメントのみを許可し、複数ステートメントや書き込み・管理用キーワードをブロックします。

• さらに、DB ユーザー自体には読み取り専用権限（db_datareader）のみを付与し、セキュリティをクエリフィルタリングだけに依存しないようにしてください。

• オプションで、DB_ALLOWED_SCHEMAS によりアクセスを特定のスキーマに制限できます。

• DB_MAX_ROWS はクエリごとの結果数を制限します。

• HTTP デプロイ（Coolify）では、MCP_AUTH_TOKEN がエンドポイントへの唯一のアクセス制限です。トークンが設定されていない場合、サーバーはネットワークアクセスを持つ誰にでも開放されます。さらに、トークンが平文で送信されないよう、Coolify プロキシ/ドメインを介した TLS を確保してください。