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: Guardrail MCP Server

Configuración

Clonar este repositorio
Instalar dependencias: pip install -r requirements.txt
Copie example.env a .env y configure su clave API de SafetyCulture
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

Instalar Claude para escritorio
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)
Agregue la siguiente configuración:

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

Reiniciar Claude para escritorio
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