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>