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을 구성합니다.- 다음 구성을 추가합니다.
- 데스크톱용 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가 더 선호됩니다.
개발
프로젝트 구조
개발 로그
초기 설정
- 프로젝트 구조 생성
- git 저장소 설정
- README 및 요구 사항 추가
- SafetyCulture API 클라이언트 구현
- 검사 데이터 쿼리를 위한 MCP 도구 추가
- 날짜 구문 분석 및 데이터 분석을 위한 유틸리티 모듈이 추가되었습니다.
- 구성 관리 추가
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
사용자가 API 키를 제공한 후 자연어를 사용하여 SafetyCulture 검사 데이터를 쿼리하고 분석할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that enables users to perform third-party enrichment lookups for security observables (IP addresses, domains, URLs, emails) through services like VirusTotal, Shodan, and others.Last updated -11Python
- -securityFlicense-qualityA minimal Model Context Protocol server that provides a safety guardrail tool to check if provided context is free from code injection or harmful content.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that provides secure curl command execution capabilities, allowing AI assistants to make HTTP requests with configurable parameters and built-in security protections.Last updated -1JavaScript
- AsecurityFlicenseAqualityA Model Context Protocol server that enables LLMs to explore and interact with API specifications by providing tools for loading, browsing, and getting detailed information about API endpoints.Last updated -41013TypeScript