mcp -iris

This MCP server implements a Model Context Protocol (MCP) interface for interacting with an InterSystems IRIS database. It enables automated data retrieval, transformation, and orchestration tasks through Claude-enabled workflows and the UV runtime. Clients can connect using the configured IRIS connection details, send MCP requests to query or manipulate IRIS data, and leverage the server’s context-aware capabilities to maintain state across steps in a workflow. The server is exposed under the iris key and is configured to use uvx to run the local mcp-server-iris module, facilitating lightweight, scriptable interactions with IRIS.

Once running, you can use Claude (or other MCP clients) to issue requests that read from or write to IRIS namespaces, execute MCP-defined procedures, and exchange contextual information for automation pipelines. The env variables specify how to connect to IRIS, including hostname, port, namespace, and credentials. This setup supports automated testing, data synchronization, and IRIS-based automation tasks within a controlled MCP environment.

Prerequisites:

• Node.js not required for this server (this server uses uvx).
• Python/uv installed and accessible in your PATH (uv/uvx tooling).
• Access to an InterSystems IRIS instance with a running namespace and user credentials.

1. Install uv (if not already installed):

   • Follow the uv installation guide for your platform: https://docs.astral.sh/uv/getting-started/installation/

2. Ensure IRIS is reachable:

   • Confirm IRIS_HOSTNAME, IRIS_PORT, IRIS_NAMESPACE, IRIS_USERNAME, and IRIS_PASSWORD reflect a valid IRIS connection.

3. Run the MCP server locally:

   • uvx mcp-server-iris
   • This uses the provided environment variables to connect to IRIS and expose the MCP endpoints.

4. Verify the server is active:

   • Check console output for successful startup messages indicating a MCP session is ready to accept requests.

5. (Optional) Integrate with Claude:

   • Configure Claude to target the iris MCP server using the provided command and environment settings.

Tips and common considerations:

• Ensure IRIS_PASSWORD handles special characters safely; consider using environment-variable masking or secret management in production.
• The MCP server relies on uvx to load the mcp-server-iris module; ensure the module path is correctly resolved in your environment.
• If the IRIS connection fails, verify network access, port binding, and that the namespace/user credentials are correct.
• You can extend the mcpServers configuration with additional env vars or multiple IRIS targets if needed for more complex workflows.
• For debugging, enable verbose logging in UV/uvx and monitor MCP request/response payloads to trace data flow.