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 キーが正しく機能するかどうかをテストするには:

test_api.bat YOUR_API_KEY

追加のテストオプション:

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で認証する

検査データ（フィードAPIを使用）

get_inspections : 特定の期間の SafetyCulture 検査を取得する
get_inspection_trends : SafetyCulture 検査の傾向を時系列で分析する
compare_injury_reports : 2つの期間の傷害報告を比較する

アクションデータ（フィード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