Ibmi MCP Server
IBM i systems access via SQL-based tool definitions using the Model Context Protocol.
Data last scanned today · Reviewed today
Overview
The Ibmi MCP Server provides a bridge between AI agents and IBM i environments. By leveraging a YAML-driven SQL engine, it enables LLMs to query Db2 for i databases, perform system monitoring, and execute database operations. This architecture allows developers to maintain consistent SQL-based tool definitions that function across both the MCP server and its accompanying command-line interface.
Our verdict
This server receives a security score of 40/100, indicating a high-risk level. Because the authentication method has not yet been reviewed and read-only mode support is unverified, users should exercise extreme caution when deploying this in environments with sensitive data. It is primarily suited for developers testing AI agent workflows on IBM i systems rather than production integration.
- Zero direct dependencies reduce potential supply-chain vulnerabilities.
- Active development with recent commits ensures responsiveness.
- Ten contributors provide a broader maintenance base.
- Standardized Apache-2.0 open-source licensing.
- Security score is low due to unreviewed authentication.
- Read-only mode support remains unverified.
- Not maintained directly by the official IBM vendor.
Setup
{
"mcpServers": {
"ibmi-mcp-server": {
"args": [
"-y",
"ibmi-mcp-monorepo"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| system_status | Overall system performance statistics with CPU, memory, and I/O metrics | low |
| find_recently_used_objects | Find objects that have been used within a specified time period | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the primary system prerequisites for running this MCP server?
You must have Node.js version 18 or higher installed and the Mapepire service running on your IBM i system at port 8076.
›How are database operations and tools defined in this server?
The server uses a YAML-driven engine where SQL tools are defined in configuration files, allowing the same tool definitions to be shared between the MCP server and the ibmi CLI.
›Can the server be deployed using containers?
Yes, the server supports deployment via Docker, Podman, and OpenShift, with specific configurations provided in the deployment guide.
›What is the role of Mapepire in this architecture?
Mapepire acts as the interface on the IBM i system that processes the SQL queries sent by the MCP server and streams the results back to the AI agent.
›How do I verify that the server is operational?
You can verify the server's status by sending a request to the health check endpoint at http://localhost:3010/healthz or by querying the list of available tools.
Changelog
- Securityv0.6.0
2026-08-26
- Securityv0.5.1
2026-04-20
- Securityv0.4.5
2026-03-24
- FixIBM i MCP Server v0.4.2
2026-03-09
- SecurityIBM i MCP Server v0.4.1
2026-03-06
- Newv0.3.2
2026-03-04
- Securityv0.3.1
2026-02-23
- Securityv0.3.0
2026-01-26
- Securityv0.2.0 - Tech Preview 1
2025-12-18
Badge
Maintain this server? Add the live badge to your README.