IRIS ObjectScript

IRIS ObjectScript MCP Server provides access to IRIS ObjectScript documentation, examples, and search tools via the Model Context Protocol (MCP). It helps you explore, open, and search documentation efficiently while developing with InterSystems IRIS.

How to use

You interact with the MCP server using a compatible MCP client. Use the available tools to search locally cached documents, open documentation by key, or navigate class documentation. Start from common tasks like looking up a class or browsing a specific namespace, then refine your search with smart search to pull in relevant results and context.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system, or prepare your Docker environment for containerized deployment.

Local development workflow (recommended for development and testing):

# Install dependencies
npm install

# Compile TypeScript
npm run build

# Run in development mode
npm run dev

# Run with MCP inspector attached
npm run dev:ins

Docker-based deployment workflow (for production or isolated environments):

# Move to deployment directory
cd deploy/

# Build and start containers
./docker-manage.sh build
./docker-manage.sh start
./setup-volumes.sh

# Check status
./docker-manage.sh status

Additional configuration and notes

The MCP server can be wired to a local wrapper script that launches the server within a containerized or local environment. Use the following configuration snippet to point the MCP client at the local wrapper and set the runtime environment.

{
  "mcpServers": {
    "iris_objectscript_docs": {
      "command": "bash",
      "args": ["/ruta/completa/deploy/iris-mcp-wrapper.sh"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Security and maintenance

The container runs as a non-root user, and MCP communication uses standard input/output without exposed ports. Volumes are used for bidirectional data persistence, including a cache of downloaded documentation and logs for troubleshooting.

Common maintenance steps include checking container status, viewing logs, and performing a clean reload when you update the codebase.

Available tools

smart_search

Intelligent search across cached documents with automatic download of relevant materials and smart mapping of terms to keys.

search_objectscript

Fast local search within downloaded documents, with contextual results and line references.

open_by_key

Open documentation directly by official KEY and automatically download/cache as needed.

open_class

Navigate documentation for ObjectScript classes, such as %Library.String, with hierarchical class browsing.