fc-devs-mcp

MCP Server para integración con InterSystems IRIS, Microsoft SQL Server y Azure DevOps, compatible con cualquier cliente MCP (Claude Desktop, Cowork, etc.).

Cada integración es completamente opcional y se activa mediante un flag de entorno. Puedes tener las tres activas al mismo tiempo, solo una, o combinarlas según tu infraestructura.

Variables de entorno

Servidor

| Variable | Requerida | Default | Descripción | | -------------------- | --------- | --------------- | ------------------------ | | MCP_SERVER_NAME | ❌ | FC-MCP-Server | Nombre del servidor MCP | | MCP_SERVER_VERSION | ❌ | 1.0.0 | Versión del servidor MCP |

InterSystems IRIS

| Variable | Requerida si enabled | Default | Descripción | | ---------------- | -------------------- | ------- | ---------------------------------------- | | IRIS_ENABLED | — | true | Habilitar integración IRIS | | IRIS_HOSTNAME | ✅ | — | Host del servidor IRIS | | IRIS_PORT | ✅ | 1972 | Puerto IRIS | | IRIS_NAMESPACE | ✅ | — | Namespace IRIS (ej. USER, APP) | | IRIS_USERNAME | ✅ | — | Usuario IRIS | | IRIS_PASSWORD | ✅ | — | Contraseña IRIS |

Microsoft SQL Server

| Variable | Requerida si enabled | Default | Descripción | | ------------------------- | -------------------- | ------- | -------------------------------------------------------------------- | | MSSQL_ENABLED | — | false | Habilitar integración SQL Server | | MSSQL_HOSTNAME | ✅ | — | Host del servidor (local, Azure SQL, K8s service DNS, etc.) | | MSSQL_PORT | ❌ | 1433 | Puerto SQL Server | | MSSQL_DATABASE | ✅ | — | Base de datos destino | | MSSQL_USERNAME | ✅ | — | Usuario SQL | | MSSQL_PASSWORD | ✅ | — | Contraseña SQL | | MSSQL_ENCRYPT | ❌ | true | TLS habilitado. Requerido en Azure SQL; false en instancias locales | | MSSQL_TRUST_SERVER_CERT | ❌ | false | Aceptar certificados autofirmados. Solo true en entornos dev |

Azure DevOps

| Variable | Requerida si enabled | Default | Descripción | | ---------------------- | -------------------- | ------- | --------------------------------------------------------- | | ADO_ENABLED | — | false | Habilitar integración Azure DevOps | | AZURE_DEVOPS_ORG_URL | ✅ | — | URL de la organización (ej. https://dev.azure.com/mi-org) | | AZURE_DEVOPS_PAT | ✅ | — | Personal Access Token de Azure DevOps |

Modo 1 — Via npx (publicado en npm)

No requiere clonar el repositorio. El cliente MCP ejecuta el paquete directamente con npx.

Solo IRIS

{
  "mcpServers": {
    "fc-mcp": {
      "command": "npx",
      "args": ["-y", "fc-devs-mcp"],
      "env": {
        "IRIS_ENABLED": "true",
        "IRIS_HOSTNAME": "10.0.0.42",
        "IRIS_PORT": "1972",
        "IRIS_NAMESPACE": "APPNS",
        "IRIS_USERNAME": "admin",
        "IRIS_PASSWORD": "s3cr3tIris!"
      }
    }
  }
}

Solo SQL Server (instancia local o en red)

{
  "mcpServers": {
    "fc-mcp": {
      "command": "npx",
      "args": ["-y", "fc-devs-mcp"],
      "env": {
        "IRIS_ENABLED": "false",
        "MSSQL_ENABLED": "true",
        "MSSQL_HOSTNAME": "10.0.1.55",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "inventory_db",
        "MSSQL_USERNAME": "app_user",
        "MSSQL_PASSWORD": "Sup3rS3cur3!",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERT": "true"
      }
    }
  }
}

Solo SQL Server (Azure SQL Database)

{
  "mcpServers": {
    "fc-mcp": {
      "command": "npx",
      "args": ["-y", "fc-devs-mcp"],
      "env": {
        "IRIS_ENABLED": "false",
        "MSSQL_ENABLED": "true",
        "MSSQL_HOSTNAME": "contoso-sql.database.windows.net",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "sales_prod",
        "MSSQL_USERNAME": "sqladmin",
        "MSSQL_PASSWORD": "Az@SQL2024!",
        "MSSQL_ENCRYPT": "true",
        "MSSQL_TRUST_SERVER_CERT": "false"
      }
    }
  }
}

SQL Server dentro de Kubernetes

{
  "mcpServers": {
    "fc-mcp": {
      "command": "npx",
      "args": ["-y", "fc-devs-mcp"],
      "env": {
        "IRIS_ENABLED": "false",
        "MSSQL_ENABLED": "true",
        "MSSQL_HOSTNAME": "sqlserver-svc.data-ns.svc.cluster.local",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "orders_db",
        "MSSQL_USERNAME": "k8s_user",
        "MSSQL_PASSWORD": "K8sP@ss2024",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERT": "true"
      }
    }
  }
}

Todas las integraciones activas

{
  "mcpServers": {
    "fc-mcp": {
      "command": "npx",
      "args": ["-y", "fc-devs-mcp"],
      "env": {
        "IRIS_ENABLED": "true",
        "IRIS_HOSTNAME": "10.0.0.42",
        "IRIS_PORT": "1972",
        "IRIS_NAMESPACE": "APPNS",
        "IRIS_USERNAME": "admin",
        "IRIS_PASSWORD": "s3cr3tIris!",
        "MSSQL_ENABLED": "true",
        "MSSQL_HOSTNAME": "10.0.1.55",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "inventory_db",
        "MSSQL_USERNAME": "app_user",
        "MSSQL_PASSWORD": "Sup3rS3cur3!",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERT": "true",
        "ADO_ENABLED": "true",
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/contoso-devs",
        "AZURE_DEVOPS_PAT": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Nota: npx -y descarga la última versión automáticamente en el primer uso. Para fijar una versión específica usa npx -y [email protected].

Modo 2 — Local (sin publicar en npm)

Útil para desarrollo o entornos sin acceso a npmjs.

Opción A — Ruta absoluta al dist compilado

git clone https://github.com/sorodriguezz/fc-devs-mcp.git
cd fc-devs-mcp
npm install
npm run build

Configura el cliente MCP apuntando al dist/index.js:

{
  "servers": {
    "fc-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"],
      "env": {
        "IRIS_ENABLED": "true",
        "IRIS_HOSTNAME": "10.0.0.42",
        "IRIS_PORT": "1972",
        "IRIS_NAMESPACE": "APPNS",
        "IRIS_USERNAME": "admin",
        "IRIS_PASSWORD": "s3cr3tIris!",
        "MSSQL_ENABLED": "false",
        "ADO_ENABLED": "false"
      }
    }
  }
}

Opción B — npm link (simula instalación global)

cd fc-devs-mcp
npm install
npm run build
npm link

{
  "mcpServers": {
    "fc-mcp": {
      "command": "fc-mcp",
      "env": {
        "IRIS_ENABLED": "true",
        "IRIS_HOSTNAME": "10.0.0.42",
        "IRIS_PORT": "1972",
        "IRIS_NAMESPACE": "APPNS",
        "IRIS_USERNAME": "admin",
        "IRIS_PASSWORD": "s3cr3tIris!"
      }
    }
  }
}

Para deshacer el link: npm unlink -g fc-devs-mcp

Tools disponibles

| Tool | Integración | Descripción | | -------------------- | -------------- | --------------------------------------------------------- | | iris_query | IRIS | Ejecuta SQL en InterSystems IRIS | | iris_production_* | IRIS | Gestión de producciones de interoperabilidad | | iris_globals_* | IRIS | Lectura/escritura de globals IRIS | | mssql_query | SQL Server | Ejecuta SQL en Microsoft SQL Server (SELECT, DML y DDL) | | (dinámicos) | Azure DevOps | Tools descubiertos dinámicamente desde el MCP oficial ADO |

Desarrollo local con inspector MCP

npm run inspect

Abre el inspector visual en http://localhost:5173 para probar las tools interactivamente.