home / mcp / iris mcp server

IRIS MCP Server

InterSystems IRIS MCP server

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "caretdev-mcp-server-iris": {
      "command": "uvx",
      "args": [
        "mcp-server-iris"
      ],
      "env": {
        "IRIS_PORT": "1972",
        "IRIS_HOSTNAME": "localhost",
        "IRIS_PASSWORD": "SYS",
        "IRIS_USERNAME": "_SYSTEM",
        "IRIS_NAMESPACE": "USER"
      }
    }
  }
}

You are using an MCP server that enables Model Context Protocol interactions with an InterSystems IRIS database. This server runs locally and exposes an IPC-style interface that lets MCP clients communicate with IRIS for automation, data access, and control tasks. It is configured to connect to IRIS using a defined set of environment values and then started through a dedicated runtime command. This guide walks you through usage patterns, installation steps, and important configuration details so you can operate the server with confidence.

How to use

Launch the MCP server to establish a bridge between your MCP client and IRIS. First ensure the server is running with the configured runtime and environment variables. Then use your MCP client to send requests that interact with IRIS data and automation tasks. Typical usage includes querying data, performing automated actions, triggering stored procedures, and reading results returned by IRIS through the MCP channel.

How to install

{
  "mcpServers": {
    "iris": {
      "command": "uvx",
      "args": [
        "mcp-server-iris"
      ],
      "env": {
        "IRIS_HOSTNAME": "localhost",
        "IRIS_PORT": "1972",
        "IRIS_NAMESPACE": "USER",
        "IRIS_USERNAME": "_SYSTEM",
        "IRIS_PASSWORD": "SYS"
      }
    }
  }
}

Additional notes and setup details

Prerequisites for running this MCP server include having the runtime available to execute the uvx command and access to an InterSystems IRIS instance. You will configure the server to point to IRIS using the environment variables shown in the snippet. When you are ready to start, you will invoke the runtime command with the arguments provided in the configuration.