Informix Db MCP

🚀 Informix MCP Server

Informixデータベースへの読み取り専用アクセスを提供するModel Context Protocol (MCP) サーバーの実装です。このサーバーは、AIアシスタントやその他のMCPクライアントがInformixデータベースを安全にクエリするための標準化されたインターフェースを提供します。

✨ 主な機能

• 完全なSQL操作のサポート：すべてのSQL操作 (SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER、DROPなど) をサポートします。
• 設定可能なセキュリティ：制限された環境でのオプションの読み取り専用モード。
• MCPプロトコル準拠：Model Context Protocol仕様の完全な実装。
• 包括的なロギング：設定可能なレベルとファイルローテーションを持つ構造化ロギング。
• Dockerサポート：docker-compose設定付きのすぐに使えるDockerコンテナ。
• セキュリティ重視：非ルートコンテナ実行と入力検証。
• 本番環境対応：ヘルスチェック、監視、およびエラーハンドリング。
• モジュール式構成：ファイルと環境変数のサポートを持つ柔軟なプロパティ管理。

サポートされる操作

読み取り専用モードが無効になっている場合 (デフォルト)、サーバーはすべてのSQL操作をサポートします。

読み取り操作:

• データクエリ用の SELECT ステートメント
• 複雑なクエリ (CTE) 用の WITH 句
• データベースの内部情報を取得する SHOW コマンド
• スキーマ情報を取得する DESCRIBE/DESC コマンド
• クエリ分析用の EXPLAIN ステートメント

書き込み操作:

• データを追加する INSERT ステートメント
• データを変更する UPDATE ステートメント
• データを削除する DELETE ステートメント
• データベースオブジェクトを作成する CREATE ステートメント
• データベースオブジェクトを変更する ALTER ステートメント
• データベースオブジェクトを削除する DROP ステートメント

注意: 設定を通じて読み取り専用モードを有効にすることで、操作を読み取り専用クエリに制限することができます。

🚀 クイックスタート

前提条件

• Java 11以上
• Maven 3.6以上
• Informixデータベースへのアクセス
• Informix JDBCドライバー (依存関係に含まれています)

設定

サーバーは2層のモジュール式構成アプローチを使用しています。

1. PropertyLoader：application.properties ファイルから生のプロパティを読み込みます。
2. ServerConfig：適切な型付けを持つ構造化された構成オブジェクトを提供します。

application.propertiesでの設定

データベース接続とサーバーパラメータを設定するには、src/main/resources/application.properties ファイルを編集します。

# データベース構成
informix.host=localhost
informix.port=23302
informix.database=testdb
informix.username=dbuser
informix.password=dbpwd
informix.server=server

# サーバー構成
mcp.server.name=informix-mcp-server
mcp.server.version=1.0.0
mcp.protocol.version=2024-11-05

# 追加設定
query.timeout.seconds=30
query.max.rows=10000
query.readonly.enforced=false
security.readonly.mode=false

# 接続プール設定 (有効にした場合)
db.connection.pool.enabled=false
db.connection.pool.max.size=10
db.connection.pool.min.size=1
db.connection.pool.timeout=30000

環境変数による上書き

環境変数は、application.properties の対応するプロパティを自動的に上書きします。構成を上書きするには、以下の変数を設定します。

export INFORMIX_HOST=<INFORMIX_HOST>
export INFORMIX_PORT=<INFORMIX_PORT>
export INFORMIX_DATABASE=<INFORMIX_DATABASE>
export INFORMIX_USERNAME=<INFORMIX_USERNAME>
export INFORMIX_PASSWORD=<INFORMIX_PASSWORD>
export INFORMIX_SERVER=<INFORMIX_SERVER>