mcp-server-db2i
An open-source Model Context Protocol server enabling AI assistants to perform read-only SQL queries and schema inspection on IBM Db2 for i. It supports ODBC, JT400 JDBC, and Mapepire over SSH drivers, enforces read-only access via SQL validation, and provides library allowlists, column masking, and OAuth 2.1 authentication for secure, audited access without installing software on the IBM i system.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 27 GitHub stars
What you can do with it
- Ask plain language questions to retrieve ERP data from IBM i
- Inspect database schemas and table structures
- Export query results to CSV or XLSX files
- Generate charts from query results in AI clients
Source and maintenance
- Last repository push
- Latest release
- v3.8.5
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
mcp-server-db2i 3.8.5
{
"version": "3.8.5",
"transport": "stdio",
"identifier": "mcp-server-db2i",
"registryType": "npm",
"environmentVariables": [
{
"name": "DB2I_HOSTNAME",
"isRequired": true,
"description": "IBM i hostname or IPv4 address",
"placeholder": "ibmi.example.com"
},
{
"name": "DB2I_USERNAME",
"isRequired": true,
"description": "IBM i user profile"
},
{
"name": "DB2I_PASSWORD",
"isRequired": true,
"description": "IBM i password"
},
{
"name": "DB2I_SCHEMA",
"description": "Default schema (library)",
"placeholder": "MYLIB"
},
{
"name": "DB2I_PROFILES",
"description": "Path to a YAML file of IBM i systems. When set, it replaces the DB2I_* connection variables"
},
{
"name": "QUERY_ALLOWED_SCHEMAS",
"description": "Comma-separated schemas the server may read. Empty disables the check.",
"placeholder": "MYLIB,OTHERLIB"
},
{
"name": "DB2I_DRIVER",
"default": "odbc",
"description": "Database driver: odbc (default, IBM i Access ODBC driver, no Java), jt400 (install node-jt400 next to the server; needs a JDK at install and a JRE at runtime) or mapepire (install @ibm/mapepire-js and ssh2; Mapepire over SSH, needs Java on the IBM i only)"
},
{
"name": "DB2I_JDBC_OPTIONS",
"description": "Extra JT400 JDBC properties, semicolon-separated (jt400 and mapepire drivers)"
},
{
"name": "DB2I_ODBC_OPTIONS",
"description": "Extra IBM i Access ODBC connection keywords, semicolon-separated (odbc driver)"
},
{
"name": "DB2I_MAPEPIRE_OPTIONS",
"description": "SSH and Mapepire settings, semicolon-separated, e.g. hostKey=SHA256:...;agent=true;maxJobs=2 (mapepire driver)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"mcp-server-db2i": {
"command": "npx",
"args": [
"-y",
"mcp-server-db2i@3.8.5"
],
"env": {
"DB2I_HOSTNAME": "<YOUR_DB2I_HOSTNAME>",
"DB2I_USERNAME": "<YOUR_DB2I_USERNAME>",
"DB2I_PASSWORD": "<YOUR_DB2I_PASSWORD>",
"DB2I_SCHEMA": "<YOUR_DB2I_SCHEMA>",
"DB2I_PROFILES": "<YOUR_DB2I_PROFILES>",
"QUERY_ALLOWED_SCHEMAS": "<YOUR_QUERY_ALLOWED_SCHEMAS>",
"DB2I_DRIVER": "<YOUR_DB2I_DRIVER>",
"DB2I_JDBC_OPTIONS": "<YOUR_DB2I_JDBC_OPTIONS>",
"DB2I_ODBC_OPTIONS": "<YOUR_DB2I_ODBC_OPTIONS>",
"DB2I_MAPEPIRE_OPTIONS": "<YOUR_DB2I_MAPEPIRE_OPTIONS>"
}
}
}
}Cline
{
"mcpServers": {
"mcp-server-db2i": {
"command": "npx",
"args": [
"-y",
"mcp-server-db2i@3.8.5"
],
"env": {
"DB2I_HOSTNAME": "<YOUR_DB2I_HOSTNAME>",
"DB2I_USERNAME": "<YOUR_DB2I_USERNAME>",
"DB2I_PASSWORD": "<YOUR_DB2I_PASSWORD>",
"DB2I_SCHEMA": "<YOUR_DB2I_SCHEMA>",
"DB2I_PROFILES": "<YOUR_DB2I_PROFILES>",
"QUERY_ALLOWED_SCHEMAS": "<YOUR_QUERY_ALLOWED_SCHEMAS>",
"DB2I_DRIVER": "<YOUR_DB2I_DRIVER>",
"DB2I_JDBC_OPTIONS": "<YOUR_DB2I_JDBC_OPTIONS>",
"DB2I_ODBC_OPTIONS": "<YOUR_DB2I_ODBC_OPTIONS>",
"DB2I_MAPEPIRE_OPTIONS": "<YOUR_DB2I_MAPEPIRE_OPTIONS>"
}
}
}
}VS Code
{
"servers": {
"mcp-server-db2i": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-db2i@3.8.5"
],
"env": {
"DB2I_HOSTNAME": "<YOUR_DB2I_HOSTNAME>",
"DB2I_USERNAME": "<YOUR_DB2I_USERNAME>",
"DB2I_PASSWORD": "<YOUR_DB2I_PASSWORD>",
"DB2I_SCHEMA": "<YOUR_DB2I_SCHEMA>",
"DB2I_PROFILES": "<YOUR_DB2I_PROFILES>",
"QUERY_ALLOWED_SCHEMAS": "<YOUR_QUERY_ALLOWED_SCHEMAS>",
"DB2I_DRIVER": "<YOUR_DB2I_DRIVER>",
"DB2I_JDBC_OPTIONS": "<YOUR_DB2I_JDBC_OPTIONS>",
"DB2I_ODBC_OPTIONS": "<YOUR_DB2I_ODBC_OPTIONS>",
"DB2I_MAPEPIRE_OPTIONS": "<YOUR_DB2I_MAPEPIRE_OPTIONS>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"mcp-server-db2i": {
"command": "npx",
"args": [
"-y",
"mcp-server-db2i@3.8.5"
],
"env": {
"DB2I_HOSTNAME": "<YOUR_DB2I_HOSTNAME>",
"DB2I_USERNAME": "<YOUR_DB2I_USERNAME>",
"DB2I_PASSWORD": "<YOUR_DB2I_PASSWORD>",
"DB2I_SCHEMA": "<YOUR_DB2I_SCHEMA>",
"DB2I_PROFILES": "<YOUR_DB2I_PROFILES>",
"QUERY_ALLOWED_SCHEMAS": "<YOUR_QUERY_ALLOWED_SCHEMAS>",
"DB2I_DRIVER": "<YOUR_DB2I_DRIVER>",
"DB2I_JDBC_OPTIONS": "<YOUR_DB2I_JDBC_OPTIONS>",
"DB2I_ODBC_OPTIONS": "<YOUR_DB2I_ODBC_OPTIONS>",
"DB2I_MAPEPIRE_OPTIONS": "<YOUR_DB2I_MAPEPIRE_OPTIONS>"
}
}
}
}Let your agent find its tools
Find servers like mcp-server-db2i from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.