Safetyculture MCP Server

🚀 安全文化 MCP サーバー

このサーバーは、SafetyCulture API 用に設計された Model Context Protocol (MCP) サーバーです。このプロジェクトでは、API キーを提供したユーザーが自然言語で SafetyCulture データを照会できます。

✨ 主な機能

• 自然言語で SafetyCulture データを照会する
• 点検データと傾向を分析する
• 異なる期間とカテゴリの安全指標を比較する
• 点検傾向を可視化する

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします：pip install -r requirements.txt
3. example.env を .env にコピーし、あなたの SafetyCulture API キーを設定します。
4. 以下のいずれかの方法でサーバーを起動します：
   • 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 の使用

1. Claude for Desktop をインストールします。
2. Claude for Desktop をこの MCP サーバーを使用するように設定します。設定ファイル ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。
3. 以下の設定を追加します：

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

4. Claude for Desktop を再起動します。
5. MCP ツールを使用して、以下のような質問であなたの SafetyCulture データを照会します：
   • “過去 3 か月間にこのサイトで何回の点検が行われましたか？”
   • “このカテゴリの負傷報告の増加傾向はどうですか？”

高度な使用法

利用可能なツール

認証

• authenticate：API キーを使用して SafetyCulture API で認証します。

点検データ（Feed API を使用）

• get_inspections：特定の期間内の SafetyCulture 点検を取得します。
• get_inspection_details：点検の詳細情報を取得します。
• search_inspection：点検を検索します。

アクションデータ（Feed API を使用）

• get_actions：アクションを取得します。
• get_action_details：アクションの詳細情報を取得します。
• search_action：アクションを検索します。

Feed API の使用に関する注意事項

複数の項目を一覧表示する必要がある場合、個別のリソースエンドポイントではなく Feed API を選択することをお勧めします。