SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体mcp-samsara

mcp-samsara

mcp-samsara 是 Automation Squad 开发的非官方 Samsara 车队管理 MCP 服务器，用于将 Claude AI 等 MCP 兼容客户端连接到 Samsara 车队管理 API。它提供 21 个工具，覆盖车辆管理、路线管理、司机管理、地址与位置、Webhook 集成和联系人管理。该集成使用用户自己的 Samsara API 凭据，基于 Samsara 公开 API 构建，与 Samsara Inc. 无关联、未获其认可或赞助。项目采用 MIT 许可证，代码开源，API 令牌保存在本地，不收集数据。当前 npm 包尚未发布，只能通过克隆仓库并构建的方式安装。

访问官网

工具介绍

用途

mcp-samsara 是一个非官方的第三方 MCP（Model Context Protocol）服务器，用于将 Claude AI 等 MCP 兼容客户端连接到 Samsara 车队管理 API。它面向需要借助 AI 助手管理车队运营的用户，提供车辆、路线、司机、地址、Webhook 和联系人等操作能力。

主要能力

该集成共提供 21 个工具，分为以下几类：

  • 车辆管理（4 个工具）：列出车辆、获取车辆详情、实时位置、统计数据。
  • 路线管理（6 个工具）：创建、更新、删除路线；自动保留站点状态（对时间跟踪至关重要）；路线优化（最小化距离/时间）；列出和获取路线详情。
  • 司机管理（4 个工具）：列出司机、获取司机详情、工时（HOS）合规跟踪、安全事件监控。
  • 地址与位置（2 个工具）：创建和管理已保存地址、地理围栏集成。
  • Webhook 集成（3 个工具）：实时事件通知、路线更新、车辆事件等。
  • 联系人管理（2 个工具）：为路线站点创建和管理联系人。

此外，每个工具描述中内置了专家知识，具备自动状态保留（站点 ID、路线数据）、智能速率限制（避免触发 API 限制）、路线优化（内置效率算法）以及生产最佳实践（错误处理、重试）。

使用方式

前置条件：Node.js 18+、Samsara API Token、Claude Desktop 或任何 MCP 兼容客户端。

注意：npm 包 @automationsquad/mcp-samsara 尚未发布，因此目前唯一可用的安装路径是克隆仓库并构建。待其发布后，将可用 npx 一行命令替代上述步骤。

配置方式：将服务器添加到 Claude Desktop 配置文件。macOS 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json。需将 /absolute/path/to/mcp-samsara 替换为克隆仓库的实际位置，路径必须为绝对路径，Claude Desktop 不解析 ~ 或相对路径。欧盟客户应使用 https://api.eu.samsara.com 作为 SAMSARA_BASE_URL。配置后退出并重新打开 Claude Desktop，即可看到 Samsara 工具。

工具命名约定：所有工具均以 samsara_ 为前缀，例如 samsara_list_vehicles、samsara_create_route、samsara_get_driver_hos。

TMS 集成：可在路线/车辆/司机中使用 externalIds 与 TMS 关联，然后通过外部 ID 查询。

适用场景

  • 通过 AI 助手创建并优化配送路线，自动保留站点 ID 以跟踪到达/离开时间。
  • 实时跟踪车辆位置，监控司机工时合规与安全事件。
  • 管理已保存地址和地理围栏，配置 Webhook 接收实时事件通知。
  • 与 TMS 系统通过 externalIds 集成。

限制

  • 这是非官方集成，与 Samsara Inc. 无关联、未获其认可或赞助，也不是官方 Samsara 产品。
  • 使用 Samsara 公开 API 和用户自己的 API 凭据，需遵守 Samsara API 服务条款。
  • 当前 npm 包未发布，只能克隆并构建安装。
  • 速率限制为保守的每秒 5 个请求，带自动节流和重试逻辑；遇到 429 会自动重试。
  • API 令牌存储在本地，不收集数据，无回传。
  • 项目处于 Beta 阶段。

架构与错误处理

采用保守的每秒 5 个请求，带自动节流和重试逻辑；对 429（速率限制）自动重试；提供清晰的错误消息和优雅降级。状态保留是关键功能：更新路线时自动获取现有路线、提取站点 ID、在更新中保留它们，防止数据丢失，避免丢失到达/离开时间。

故障排除

  • 提示“Error: SAMSARA_API_TOKEN environment variable is required”：在 Claude 配置文件中设置 API 令牌。
  • 提示“Samsara API error (401): Unauthorized”：API 令牌无效或过期，需在 Samsara 仪表板生成新令牌。
  • 提示“Samsara API error (429): Too Many Requests”：MCP 会自动重试；若频繁出现，可能有其他集成在访问 API。
  • 工具未显示在 Claude 中：检查配置文件语法（有效 JSON）、完全重启 Claude（退出并重新打开）、检查 Claude 日志中的错误。

安全与隐私

凭据保留在本地，API 令牌存储在用户机器上；不收集数据；开源，可自行审查代码；无回传，MCP 完全在本地运行。

未来计划

增加更多工具（调度、资产、标签）、支持批量操作、增强优化算法、多路线优化、燃油成本计算、合规报告工具。

许可证：MIT。

同类工具

查看分类