Integrations

Enables configuration management through .env files, allowing users to securely store their SafetyCulture API keys and other configuration parameters.
Provides version control integration through Git, allowing users to clone the repository as part of the setup process.
Uses Python as the runtime environment for the MCP server, with the server being executed through Python commands in the Claude Desktop configuration.

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 密钥是否正常工作：

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

安装Claude 桌面版
通过编辑配置文件~/Library/Application Support/Claude/claude_desktop_config.json (Mac) 或%APPDATA%\Claude\claude_desktop_config.json (Windows)，配置 Claude for Desktop 使用此 MCP 服务器
添加以下配置：

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

重启 Claude 桌面版
使用 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 工具
添加了用于日期解析和数据分析的实用程序模块
增加了配置管理

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

模型上下文协议服务器允许用户在提供 API 密钥后使用自然语言查询和分析他们的 SafetyCulture 检查数据。

Appeared in Searches

A search for information or resources related to reports