Integrations

Enables configuration management through .env files, allowing users to securely store their SafetyCulture API keys and other configuration parameters.
Provides version control integration through Git, allowing users to clone the repository as part of the setup process.
Uses Python as the runtime environment for the MCP server, with the server being executed through Python commands in the Claude Desktop configuration.

SafetyCulture MCP 서버

SafetyCulture API를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 프로젝트는 사용자가 API 키를 제공한 후 SafetyCulture 데이터에 대한 자연어 질문을 할 수 있도록 지원합니다.

특징

자연어를 사용하여 SafetyCulture 데이터 쿼리
검사 데이터 및 추세 분석
기간 및 범주별 안전 지표 비교
시간 경과에 따른 검사 추세를 시각화합니다.

설정

이 저장소를 복제하세요
종속성 설치: pip install -r requirements.txt
example.env``.env 로 복사하고 SafetyCulture API 키를 구성하세요.
다음 방법 중 하나를 사용하여 서버를 실행하세요.
- run_server.bat - .env 파일의 구성으로 서버를 실행합니다.
- run_with_key.bat YOUR_API_KEY - 제공된 API 키로 서버를 실행합니다.

API 테스트

SafetyCulture API 키가 제대로 작동하는지 테스트하려면 다음을 수행하세요.

지엑스피1

추가 테스트 옵션:

test_api.bat - 대화형 모드로 테스트 실행(API 키 입력 요구)
test_api.bat feed YOUR_API_KEY - Feed API만 테스트
test_api.bat url - 인증 없이 접근 가능한 API URL 확인

Claude for Desktop 사용

데스크톱용 Claude 설치
~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)의 구성 파일을 편집하여 이 MCP 서버를 사용하도록 Claude for Desktop을 구성합니다.
다음 구성을 추가합니다.

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

데스크톱용 Claude를 다시 시작하세요
MCP 도구를 사용하여 다음과 같은 질문을 통해 SafetyCulture 데이터를 쿼리하세요.
- "지난 3개월 동안 이 사이트에서 몇 건의 검사가 이루어졌나요?"
- "이 범주에 대한 부상 증가 보고서의 추세를 비교하세요"

사용 가능한 도구

입증

authenticate : API 키를 사용하여 SafetyCulture API로 인증합니다.

검사 데이터(Feed API 사용)

get_inspections : 특정 기간 동안의 SafetyCulture 검사를 가져옵니다.
get_inspection_trends : 시간 경과에 따른 SafetyCulture 검사 추세 분석
compare_injury_reports : 두 기간 간의 부상 보고서를 비교합니다.

액션 데이터(피드 API 사용)

get_actions : 특정 기간 동안의 SafetyCulture 작업 가져오기
- 상태별 필터링(예: '진행 중', '완료', '기한 초과')
- 우선순위별로 필터링합니다(예: '낮음', '보통', '높음')
- 각 작업에 대한 자세한 정보를 확인하세요
get_action_details : ID로 특정 작업에 대한 자세한 정보를 가져옵니다.

피드 API에 대하여

이 MCP 서버는 리소스 컬렉션에 액세스하는 간단한 방법을 제공하는 SafetyCulture Feed API를 사용합니다.

/feed/inspections : 다양한 필터 매개변수를 사용하여 검사를 나열합니다.
/feed/actions : 다양한 필터 매개변수를 사용하여 작업을 나열합니다.

여러 항목을 나열해야 하는 경우 개별 리소스 엔드포인트보다 Feed API가 더 선호됩니다.

개발

프로젝트 구조

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

개발 로그

초기 설정

프로젝트 구조 생성
git 저장소 설정
README 및 요구 사항 추가
SafetyCulture API 클라이언트 구현
검사 데이터 쿼리를 위한 MCP 도구 추가
날짜 구문 분석 및 데이터 분석을 위한 유틸리티 모듈이 추가되었습니다.
구성 관리 추가

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

사용자가 API 키를 제공한 후 자연어를 사용하여 SafetyCulture 검사 데이터를 쿼리하고 분석할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Appeared in Searches

A search for information or resources related to reports