abbottdevelopments/shopmonkey-mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

3 stars 8 forks Качество 83 Тренд 24MIT

MCP server for the Shopmonkey REST API (v3) — 69 tools for work orders, customers, vehicles, inventory, appointments, labor, and more

Обзор

A Model Context Protocol (MCP) server that wraps the Shopmonkey REST API (v3), enabling AI agents and LLMs to interact with shop management data — work orders, customers, vehicles, inventory, appointments, payments, labor, canned services, webhooks, and more. - across 12 resource groups covering the Shopmonkey API - — stdio for local/desktop use, Streamable HTTP for cloud deployment - Shopmonkey API key authentication (Bearer token to Shopmonkey REST API) - Automatic retry with exponential backoff on rate limits (429) and server errors (5xx) - Request concurrency control (max 5 simultaneous API calls) - 30-second request timeout per call - Multi-location support via SHOPMONKEY_LOCATION_ID or per-request locationId - Descriptive error messages surfacing Shopmonkey error codes and messages - HTTP transport includes bearer auth, health check endpoint, and graceful shutdown - Works with Claude Desktop, Cursor, Claude Code, Claude.ai, and any MCP-compatible client Copy .env.example to .

README

Показан фрагмент оригинального README. Открыть оригинал.

Shopmonkey MCP Server

Features

70 tools across 12 resource groups covering the Shopmonkey API
Dual transport — stdio for local/desktop use, Streamable HTTP for cloud deployment
Shopmonkey API key authentication (Bearer token to Shopmonkey REST API)
Automatic retry with exponential backoff on rate limits (429) and server errors (5xx)
Request concurrency control (max 5 simultaneous API calls)
30-second request timeout per call
Multi-location support via SHOPMONKEY_LOCATION_ID or per-request locationId
Descriptive error messages surfacing Shopmonkey error codes and messages
HTTP transport includes bearer auth, health check endpoint, and graceful shutdown
Works with Claude Desktop, Cursor, Claude Code, Claude.ai, and any MCP-compatible client

Quick Start

git clone https://github.com/AbbottDevelopments/shopmonkey-mcp-server.git
cd shopmonkey-mcp-server
npm install
npm run build

Copy .env.example to .env and add your Shopmonkey API key:

cp .env.example .env
# Edit .env — set SHOPMONKEY_API_KEY to your key

Start the server:

# stdio (local use with Claude Desktop, Cursor, Claude Code)
npm start

# HTTP (cloud deployment, Claude.ai)
npm run start:http

Transports

The server ships two entry points sharing a single tool registry — use whichever matches your deployment target.

stdio (local use)

node dist/index.js
# or: npm start

Your MCP client spawns this process directly. Used by Claude Desktop, Cursor, and Claude Code. See MCP Client Configuration below.

Streamable HTTP (cloud deployment)

PORT=3000 node dist/http.js
# or: npm run start:http

The HTTP server listens on PORT (default 3000) and handles MCP requests at /. Required for cloud deployment (Railway, Render) and for connecting to Claude.ai.

HTTP features:

Authentication — Set MCP_AUTH_TOKEN to require Authorization: Bearer on all MCP requests. Open access when unset (local development).
Health check — GET /health and GET / return {"status":"ok"} for load balancer probes.
Graceful shutdown — Clean exit on SIGTERM/SIGINT with a 5-second timeout.

For cloud deployment instructions, see docs/DEPLOYMENT.md.

Tool Reference

Work Orders (5 tools)

Tool	Description

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "shopmonkey": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/shopmonkey-mcp-server",
      "env": {
        "SHOPMONKEY_API_KEY": "your_api_key_here"
      }
    }
  }
}