Servidor MCP de Infactory

Un servidor MCP (Model Context Protocol) para interactuar con las APIs de Infactory utilizando Claude y otros LLMs. Este servidor permite a los modelos lingüísticos acceder y manipular datos en su entorno Infactory.

Características

• Gestión de proyectos: Lista, recupera y crea proyectos
• Programas de consulta: Lista y ejecución de programas de consulta
• Fuentes de datos: Listar, recuperar y crear fuentes de datos
• Gestión de usuarios y equipos: Obtener información actual de usuarios y listar equipos

Primeros pasos

Requisitos previos

• Clave API de Infactory
• Node.js 18+ (para instalación local)

Instalación

Usando NPX (Recomendado)

npx -y @infactory/infactory-mcp

Usando Docker

docker run -i --rm \ -e NF_API_KEY="tu_clave_api_aquí" \ @infactory/infactory-mcp

Variables de entorno

• NF_API_KEY (obligatorio): Su clave de API de Infactory
• NF_BASE_URL (opcional): Punto final de API personalizado si utiliza un entorno diferente

Herramientas disponibles

Herramientas de proyecto

• list_projects: Lista todos los proyectos disponibles

  • No se requieren parámetros

• get_project: Obtener detalles de un proyecto específico

  • Parámetros
    • project_id (cadena): ID del proyecto a recuperar

• crear_proyecto: Crear un nuevo proyecto

  • Parámetros
    • name (cadena): Nombre del proyecto
    • description (cadena, opcional): Descripción del proyecto
    • team_id (cadena): ID del equipo

Herramientas de consulta de programas

• list_query_programs: Lista los programas de consulta de un proyecto

  • Parámetros
    • project_id (cadena): ID del proyecto

• ejecutar_programa_de_consulta: Ejecutar un programa de consulta

  • Parámetros
    • queryprogram_id (cadena): ID del programa de consulta a ejecutar
    • datos_entrada (objeto, opcional): Datos de entrada para el programa de consulta

Herramientas de fuentes de datos

• list_datasources: Lista las fuentes de datos de un proyecto

  • Parámetros
    • project_id (cadena): ID del proyecto

• get_datasource: Obtener detalles de una fuente de datos específica

  • Parámetros
    • datasource_id (cadena): ID de la fuente de datos

• create_datasource: Crear una nueva fuente de datos

  • Parámetros
    • name (cadena): Nombre de la fuente de datos
    • project_id (cadena): ID del proyecto
    • type (cadena): Tipo de fuente de datos

Herramientas de usuario y equipo

• get_current_user: Obtener información sobre el usuario actual

  • No requiere parámetros

• list_teams: Lista los equipos de una organización

  • Parámetros
    • organization_id (cadena): ID de la organización

Uso con Claude Desktop + Windsurf + Cursor

Esta es la ubicación probable de su archivo de configuración MCP:

• Claude Desktop - Añádalo a su claude_desktop_config.json:
• Windsurf - Añádalo a su ~/.codeium/windsurf/mcp_config.json:
• Cursor - Añada esto a su ~/.cursor/mcp.json:

Añade esto a tu configuración MCP:

{ "version": "0.1", "mcpServers": { "infactory-mcp": { "command": "npx", "args": ["-y", "@infactory/infactory-mcp"], "env": { "NF_API_KEY": "nf-************************" } } }

{ "version": "0.1", "mcpServers": { "infactory-mcp": { "command": "npx", "args": ["-y", "@infactory/infactory-mcp@0.6.1"], "env": { "NF_API_KEY": "nf-2FEUOhBAeMOtzyTqK1VEMFc7D-AMsL89gQOTsDURJn0", "NF_BASE_URL": "http://localhost:8000" } } }

O si estás haciendo desarrollo:

{ "version": "0.1", "mcpServers": { "infactory-mcp": { "command": "node", "args": ["FULL_PATH_TO/infactory-mcp/dist/index.js"], "env": { "NF_API_KEY": "nf-************************" } } } }

Avisos de ejemplo

Una vez que el servidor MCP esté configurado, puede utilizar preguntas como éstas con Claude:

• "Muéstrame una lista de todos mis proyectos Infactory"
• "Obtener los detalles del proyecto proj-123abc
• "Crear un nuevo proyecto llamado 'Análisis de Datos' en el equipo team-456xyz"
• "Listar todos los programas de consulta en el proyecto proj-123abc"
• "Ejecutar el programa de consulta qp-789def"
• "Háblame de mí (mi cuenta de usuario)"

Construir desde el código fuente

# Clonar el repositorio git clone https://github.com/yourusername/mcp-server-infactory.git cd mcp-server-infactory # Instalar dependencias npm install # Construir npm run build # Arrancar el servidor npm start # Opcional - arrancar inspector (para depuración) npx @modelcontextprotocol/inspector -e "NF_API_KEY=$NF_API_KEY" node -- dist/index.js

Licencia

Licencia MIT