AI导哈

Cariot MCP 服务器

Cariot MCP Server 是一个通过 Model Context Protocol 对接 Cariot API 的服务器，用于在车队管理场景中提供日常报告、驾驶员、车辆、实时设备快照及酒精检测合规分析等数据服务。

  • by CariotInc
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 CariotInc/cariot-mcp-server

使用说明

Cariot MCP Server

A Model Context Protocol (MCP) server with cariot APIs.

Quick Start

Prerequisites

  • Node.js v22+ (ES modules support)
  • Cariot API credentials (one of the following):
    • API Access Key and Secret
    • ID Token (from Cariot authentication)

Configuration

Add the following configuration to your MCP-enabled client (e.g., Claude Desktop) settings.

Option 1: API Key Authentication (Recommended)

{
  "mcpServers": {
    "cariot": {
      "command": "npx",
      "args": ["@cariot-labs/cariot-mcp-server"],
      "env": {
        "API_ACCESS_KEY": "your-api-access-key",
        "API_ACCESS_SECRET": "your-api-access-secret"
      }
    }
  }
}

Option 2: ID Token Authentication

{
  "mcpServers": {
    "cariot": {
      "command": "npx",
      "args": ["@cariot-labs/cariot-mcp-server"],
      "env": {
        "ID_TOKEN": "your-id-token"
      }
    }
  }
}

Environment Variables

Authentication (one of the following is required):

Variable Description
API_ACCESS_KEY Cariot API access key (used with API_ACCESS_SECRET)
API_ACCESS_SECRET Cariot API access secret (used with API_ACCESS_KEY)
ID_TOKEN Cariot ID token for authentication

Note: If both API key credentials and ID token are provided, API key authentication takes priority.

Optional:

Variable Description Default
CARIOT_LOG_LEVEL Logging level (debug, info, warn, error) info

No Installation Required

npx automatically downloads and runs the server.

Available Tools

Cariot Tools

  • analyze_alcohol_checks: Analyze alcohol check results from daily reports to monitor compliance and identify violations.
  • get_daily_report: Get a specific daily report by daily report number.
  • get_daily_reports: List daily reports.
  • get_drivers: List drivers.
  • get_vehicles: List vehicles.
  • get_realtime: Get realtime snapshots for devices.

Development

Local Development

# Clone repository
git clone https://github.com/CariotInc/cariot-mcp-server.git
cd cariot-mcp-server
npm install

# Test
npm test

# Build
npm run build

Local Configuration

Using API Key:

{
  "mcpServers": {
    "cariot": {
      "command": "node",
      "args": ["/path/to/cariot-mcp-server/dist/index.js"],
      "env": {
        "API_ACCESS_KEY": "your-access-key",
        "API_ACCESS_SECRET": "your-access-secret",
        "CARIOT_LOG_LEVEL": "debug"
      }
    }
  }
}

License

MIT

相关 MCP