OfficialVerified

Ibmi MCP Server

IBM i systems access via SQL-based tool definitions using the Model Context Protocol.

Data last scanned today · Reviewed today

632 tools78TypeScriptApache-2.0

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

Claude Desktop
{
  "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

ToolDescriptionRisk
system_statusOverall system performance statistics with CPU, memory, and I/O metricslow
find_recently_used_objectsFind objects that have been used within a specified time periodlow

Compatibility

ClientLocalDockerRemoteRead-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

Badge

Ibmi MCP Server security score, rated on RepoAI

Maintain this server? Add the live badge to your README.