Zerubroberts Safetyculture MCP Server

🚀 安全文化 MCP サーバー

このサーバーは、SafetyCulture API 用に構築されたモデルコンテキストプロトコル（MCP）サーバーです。このプロジェクトを使用すると、ユーザーは API キーを提供した後、自然言語で安全文化データを照会することができます。

✨ 主な機能

• 自然言語で安全文化データを照会する
• 検査データとトレンドを分析する
• 異なる時期やカテゴリの安全指標を比較する
• 時間の経過に伴う検査トレンドを可視化する

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします：pip install -r requirements.txt
3. example.env を .env にコピーし、あなたの安全文化 API キーを設定します。
4. 以下のいずれかの方法でサーバーを起動します：
   • run_server.bat - .env ファイルの設定を使用してサーバーを起動します。
   • run_with_key.bat YOUR_API_KEY - 提供された API キーを使用してサーバーを起動します。

💻 使用例

基本的な使用法

API のテスト

あなたの安全文化 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 ツールを使用して、以下のような質問で安全文化データを照会します：
   • “過去 3 か月間にこのサイトで何回の検査が行われましたか？”
   • “このカテゴリの報告された傷害の傾向を比較してください”

高度な使用法

利用可能なツール

認証

• authenticate：API キーを使用して安全文化 API で認証します。

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

• get_inspections：特定の期間の安全文化検査を取得します。
• get_inspection_trends：時間の経過に伴う安全文化検査の傾向を分析します。
• compare_injury_reports：2 つの期間の傷害報告を比較します。

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

• get_actions：特定の期間の安全文化アクションを取得します。
  • 状態でフィルタリングします（例：“進行中”、“完了”、“overdue”）。
  • 優先度でフィルタリングします（例：“低”、“中”、“高”）。
  • 各アクションの詳細を表示します。
• get_action_details：ID で特定のアクションの詳細を取得します。

Feed API について

この MCP サーバーは、安全文化 Feed API を使用しています。この API は、リソースコレクションにアクセスする簡単な方法を提供します：

• /feed/inspections：様々なフィルタパラメータで検査を一覧表示します。
• /feed/actions：様々なフィルタパラメータでアクションを一覧表示します。 複数の項目を一覧表示する必要がある場合、Feed API は個々のリソースエンドポイントよりも優先されます。

🔧 技術詳細

プロジェクト構造

.
├── README.md
├── requirements.txt
├── example.env
└── src/
    ├── main.py                      # メインエントリーポイント
    ├── safetyculture_api/           # 安全文化 API クライアント
    │   ├── __init__.py
    │   └── client.py                # API クライアントの実装
    ├── tools/                       # MCP ツール
    │   ├── __init__.py
    │   └── inspection_tools.py      # 検査とアクションツール
    └── utils/                       # ツールモジュール
        ├── __init__.py
        ├── analysis.py              # データ分析ユーティリティ
        ├── config.py                # 設定管理
        └── date_utils.py            # 日付解析ユーティリティ

開発ログ

初期設定

• プロジェクト構造を作成します。
• Git リポジトリを設定します。
• README と requirements を追加します。
• 安全文化 API クライアントを実装します。
• 検査データを照会するための MCP ツールを追加します。
• 日付解析とデータ分析のためのツールモジュールを追加します。
• 設定管理を追加します。