SafetyCulture MCP Server

Faça perguntas em linguagem natural sobre seus dados do SafetyCulture usando a

GitHubExperimente este MCPPatrocinado

Documentação

SafetyCulture MCP Server

Um servidor Model Context Protocol (MCP) para a API SafetyCulture. Este projeto permite aos usuários fazer perguntas em linguagem natural sobre seus dados do SafetyCulture após fornecer uma chave de API.

Recursos

  • Consultar dados do SafetyCulture usando linguagem natural
  • Analisar dados e tendências de inspeções
  • Comparar métricas de segurança entre períodos e categorias
  • Visualizar tendências de inspeção ao longo do tempo

Configuração

  1. Clone este repositório
  2. Instale as dependências: pip install -r requirements.txt
  3. Copie example.env para .env e configure sua chave de API do SafetyCulture
  4. Execute o servidor usando um destes métodos:
    • run_server.bat - Execute o servidor com configuração do arquivo .env
    • run_with_key.bat YOUR_API_KEY - Execute o servidor com a chave de API fornecida

Testando a API

Para testar se sua chave de API do SafetyCulture funciona corretamente:

test_api.bat YOUR_API_KEY

Opções adicionais de teste:

  • test_api.bat - Execute os testes em modo interativo (solicita a chave de API)
  • test_api.bat feed YOUR_API_KEY - Teste apenas a API Feed
  • test_api.bat url - Verifique quais URLs de API são acessíveis sem autenticação

Uso com Claude for Desktop

  1. Instale Claude for Desktop
  2. Configure o Claude for Desktop para usar este servidor MCP editando o arquivo de configuração em ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)
  3. Adicione a seguinte configuração:
{
    "mcpServers": {
        "safetyculture": {
            "command": "python",
            "args": [
                "/path/to/your/project/src/main.py"
            ]
        }
    }
}
  1. Reinicie o Claude for Desktop
  2. Use as ferramentas MCP para consultar seus dados do SafetyCulture com perguntas como:
    • "Quantas inspeções foram feitas neste local nos últimos 3 meses?"
    • "Compare tendências no aumento de relatórios de lesões para esta categoria"

Ferramentas Disponíveis

Autenticação

  • authenticate: Autentique-se com a API SafetyCulture usando sua chave de API

Dados de Inspeção (usando a API Feed)

  • get_inspections: Obtenha inspeções do SafetyCulture para um período de tempo específico
  • get_inspection_trends: Analise tendências em inspeções do SafetyCulture ao longo do tempo
  • compare_injury_reports: Compare relatórios de lesões entre dois períodos de tempo

Dados de Ações (usando a API Feed)

  • get_actions: Obtenha ações do SafetyCulture para um período de tempo específico
    • Filtre por status (ex.: 'in_progress', 'completed', 'overdue')
    • Filtre por prioridade (ex.: 'low', 'medium', 'high')
    • Veja informações detalhadas sobre cada ação
  • get_action_details: Obtenha informações detalhadas sobre uma ação específica pelo ID

Sobre a API Feed

Este servidor MCP usa a API Feed do SafetyCulture, que fornece uma maneira simples de acessar coleções de recursos:

  • /feed/inspections: Para listar inspeções com vários parâmetros de filtro
  • /feed/actions: Para listar ações com vários parâmetros de filtro

A API Feed é preferida em relação aos endpoints de recursos individuais quando você precisa listar vários itens.

Desenvolvimento

Estrutura do Projeto

.
├── 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

Log de Desenvolvimento

Configuração Inicial

  • Estrutura do projeto criada
  • Repositório git configurado
  • README e requirements adicionados
  • Cliente da API SafetyCulture implementado
  • Ferramentas MCP adicionadas para consultar dados de inspeção
  • Módulos utilitários adicionados para análise de datas e análise de dados
  • Gerenciamento de configuração adicionado