SafetyCulture MCP 服务器

用于 SafetyCulture API 的模型上下文协议 (MCP) 服务器。该项目允许用户在提供 API 密钥后，使用自然语言询问有关其 SafetyCulture 数据的问题。

特征

• 使用自然语言查询 SafetyCulture 数据

• 分析检查数据和趋势

• 比较不同时间段和类别的安全指标

• 可视化随时间变化的检查趋势

Related MCP server: SQLite MCP Server

设置

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 桌面版一起使用

1. 安装Claude 桌面版

2. 通过编辑配置文件~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 或%APPDATA%\Claude\claude_desktop_config.json (Windows)，配置 Claude for Desktop 使用此 MCP 服务器

3. 添加以下配置：

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

4. 重启 Claude 桌面版

5. 使用 MCP 工具查询您的 SafetyCulture 数据，例如：

   • “过去 3 个月内，该站点进行了多少次检查？”

   • “比较此类别受伤人数上升趋势报告”

可用工具

验证

• authenticate ：使用您的 API 密钥通过 SafetyCulture API 进行身份验证

检查数据（使用 Feed API）

• get_inspections ：获取特定时间段内的 SafetyCulture 检查

• get_inspection_trends ：分析 SafetyCulture 检查随时间变化的趋势

• compare_injury_reports ：比较两个时间段内的伤害报告

动作数据（使用 Feed API）

• get_actions ：获取特定时间段内的 SafetyCulture 操作

  • 按状态过滤（例如“进行中”、“已完成”、“逾期”）

  • 按优先级过滤（例如“低”、“中”、“高”）

  • 查看每个操作的详细信息

• get_action_details ：通过 ID 获取特定操作的详细信息

关于 Feed 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

开发日志

初始设置

• 创建项目结构

• 设置 git 仓库

• 添加了 README 和要求

• 实施 SafetyCulture API 客户端

• 添加了用于查询检查数据的 MCP 工具

• 添加了用于日期解析和数据分析的实用程序模块

• 增加了配置管理