Informix Db MCP

🚀 Informix MCP 服務器

這是一個用於只讀訪問 Informix 數據庫的模型上下文協議 (MCP) 服務器實現。該服務器為 AI 助手和其他 MCP 客戶端提供了一個標準化接口，可安全地查詢 Informix 數據庫。

✨ 主要特性

• 全面支持 SQL 操作：支持所有 SQL 操作（SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER、DROP 等）
• 可配置的安全性：在受限環境中可選擇只讀模式
• 符合 MCP 協議：完全實現了模型上下文協議規範
• 全面的日誌記錄：結構化日誌記錄，支持可配置的日誌級別和文件輪轉
• 支持 Docker：提供可直接使用的 Docker 容器，並支持 docker-compose 配置
• 安全至上：以非根用戶身份執行容器，並進行輸入驗證
• 適合生產環境：具備健康檢查、監控和錯誤處理功能
• 模塊化配置：支持通過文件和環境變量進行靈活的屬性管理

📦 安裝指南

前提條件

• Java 11 或更高版本
• Maven 3.6 或更高版本
• 能夠訪問 Informix 數據庫
• Informix JDBC 驅動（已包含在依賴項中）

配置

服務器採用兩層模塊化配置方式：

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>

🚀 快速開始

支持的操作

當禁用只讀模式（默認設置）時，服務器支持所有 SQL 操作： 讀操作：

• SELECT 語句用於數據查詢
• WITH 子句用於複雜查詢（CTE）
• SHOW 命令用於數據庫內省
• DESCRIBE/DESC 命令用於獲取模式信息
• EXPLAIN 語句用於查詢分析

寫操作：

• INSERT 語句用於添加數據
• UPDATE 語句用於修改數據
• DELETE 語句用於刪除數據
• CREATE 語句用於創建數據庫對象
• ALTER 語句用於修改數據庫對象
• DROP 語句用於刪除數據庫對象

注意：可以通過配置啟用只讀模式，將操作限制為只讀查詢。

前提條件

• Java 11 或更高版本
• Maven 3.6 或更高版本
• 能夠訪問 Informix 數據庫
• Informix JDBC 驅動（已包含在依賴項中）

配置

服務器採用兩層模塊化配置方式：

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>