SafetyCulture MCP 服务器

一个用于 SafetyCulture API 的模型上下文协议 (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_trends: 分析 SafetyCulture 检查随时间变化的趋势
• compare_injury_reports: 比较两个时间段内的受伤报告

行动数据 (使用 Feed API)

• get_actions: 获取特定时间段内的 SafetyCulture 行动
  • 按状态过滤（例如，“进行中”、“已完成”、“已过期”）
  • 按优先级过滤（例如，“低”、“中”、“高”）
  • 查看每个行动的详细信息
• get_action_details: 按 ID 获取特定行动的详细信息

关于 Feed API

此 MCP 服务器使用 SafetyCulture Feed API，该 API 提供了一种访问资源集合的简单方法：

• /feed/inspections: 用于列出具有各种过滤参数的检查
• /feed/actions: 用于列出具有各种过滤参数的行动

当您需要列出多个项目时，Feed API 优于单个资源端点。

开发

项目结构

.
├── README.md
├── requirements.txt
├── example.env
└── src/
    ├── main.py                      # 主要入口点
    ├── safetyculture_api/           # SafetyCulture 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
• 实现 SafetyCulture API 客户端
• 添加用于查询检查数据的 MCP 工具
• 添加用于日期解析和数据分析的实用程序模块
• 添加配置管理