Servidor MCP de SafetyCulture

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de SafetyCulture. Este proyecto permite a los usuarios formular preguntas en lenguaje natural sobre sus datos de SafetyCulture tras proporcionar una clave de API.

Características

• Consultar datos de SafetyCulture mediante lenguaje natural

• Analizar datos y tendencias de inspección

• Comparar métricas de seguridad en distintos períodos de tiempo y categorías

• Visualizar las tendencias de inspección a lo largo del tiempo

Related MCP server: SQLite MCP Server

Configuración

1. Clonar este repositorio

2. Instalar dependencias: pip install -r requirements.txt

3. Copie example.env a .env y configure su clave API de SafetyCulture

4. Ejecute el servidor utilizando uno de estos métodos:

   • run_server.bat - Ejecuta el servidor con la configuración del archivo .env

   • run_with_key.bat YOUR_API_KEY - Ejecuta el servidor con la clave API proporcionada

Probando la API

Para probar si su clave API de SafetyCulture funciona correctamente:

test_api.bat YOUR_API_KEY

Opciones de prueba adicionales:

• test_api.bat : ejecuta pruebas en modo interactivo (solicita la clave API)

• test_api.bat feed YOUR_API_KEY - Prueba solo la API de feed

• test_api.bat url : comprueba qué URL de API son accesibles sin autenticación

Uso con Claude para escritorio

1. Instalar Claude para escritorio

2. Configure Claude for Desktop para usar este servidor MCP editando el archivo de configuración en ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) o %APPDATA%\Claude\claude_desktop_config.json (Windows)

3. Agregue la siguiente configuración:

{
    "mcpServers": {
        "safetyculture": {
            "command": "python",
            "args": [
                "/path/to/your/project/src/main.py"
            ]
        }
    }
}

4. Reiniciar Claude para escritorio

5. Utilice las herramientas MCP para consultar sus datos de SafetyCulture con preguntas como:

   • ¿Cuántas inspecciones se realizaron en este sitio durante los últimos 3 meses?

   • Compare las tendencias en el aumento de lesiones en el informe para esta categoría.

Herramientas disponibles

Autenticación

• authenticate : autenticarse con la API de SafetyCulture usando su clave API

Datos de inspección (mediante la API de feeds)

• get_inspections : Obtener inspecciones de SafetyCulture para un período de tiempo específico

• get_inspection_trends : Analizar las tendencias en las inspecciones de SafetyCulture a lo largo del tiempo

• compare_injury_reports : Comparar informes de lesiones entre dos períodos de tiempo

Datos de acción (usando la API de feeds)

• get_actions : Obtener acciones de SafetyCulture para un período de tiempo específico

  • Filtrar por estado (por ejemplo, 'en progreso', 'completado', 'vencido')

  • Filtrar por prioridad (por ejemplo, 'baja', 'media', 'alta')

  • Ver información detallada sobre cada acción

• get_action_details : Obtenga información detallada sobre una acción específica por ID

Acerca de la API de feeds

Este servidor MCP utiliza la API de feed de SafetyCulture, que proporciona una forma sencilla de acceder a colecciones de recursos:

• /feed/inspections : Para enumerar inspecciones con varios parámetros de filtro

• /feed/actions : Para enumerar acciones con varios parámetros de filtro

Se prefiere la API de feed a los puntos finales de recursos individuales cuando necesita enumerar varios elementos.

Desarrollo

Estructura del proyecto

.
├── README.md
├── requirements.txt
├── example.env
└── src/
    ├── main.py                      # Main entry point
    ├── safetyculture_api/           # SafetyCulture API client
    │   ├── __init__.py
    │   └── client.py                # API client implementation
    ├── tools/                       # MCP tools
    │   ├── __init__.py
    │   └── inspection_tools.py      # Inspection and action tools
    └── utils/                       # Utility modules
        ├── __init__.py
        ├── analysis.py              # Data analysis utilities
        ├── config.py                # Configuration management
        └── date_utils.py            # Date parsing utilities

Registro de desarrollo

Configuración inicial

• Estructura del proyecto creado

• Configurar el repositorio git

• Se agregaron README y requisitos

• Se implementó el cliente API de SafetyCulture

• Se agregaron herramientas MCP para consultar datos de inspección

• Se agregaron módulos de utilidad para el análisis de fechas y datos.

• Se agregó gestión de configuración