SafetyCulture MCP 서버

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

특징

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

Related MCP server: Guardrail MCP Server

설정

이 저장소를 복제하세요
종속성 설치: 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