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 fc-devs-mcp@1.0.0.

---

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.