vespo92/mindbodymcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 12 forks 质量 70 趋势 18MIT

Repository Install

MCP Server to interact with Mindbody for ease of access between yoga studios and their websites

概览

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with complete access to the Mindbody API for fitness and wellness studio management. Perfect for yoga studios, pilates studios, gyms, and wellness centers. - covering every aspect of studio operations - - View schedules, book clients, manage waitlists, substitute teachers - - Add/update clients, track visits, memberships, and balances - - Process payments, sell packages, memberships, and retail products - - View schedules, manage appointments, track availability - - Manage multiple studio locations seamlessly - - Built on Bun runtime with intelligent caching - - Full TypeScript support with comprehensive types - - STDIO for local development, SSE for production deployment - Node.js 18+ or Bun 1.0+ - Mindbody API credentials (API Key, Site ID, Source credentials) - Claude Desktop or any MCP-compatible client 1. Sign up for a Mindbody Developer Account 2. Create a new app to get your API credentials 3.

README

以下为原文 README 节选，完整内容请查看原文。

🧘 Mindbody MCP Server

✨ Features

50+ Tools covering every aspect of studio operations
Complete Class Management - View schedules, book clients, manage waitlists, substitute teachers
Client Management - Add/update clients, track visits, memberships, and balances
Sales & Commerce - Process payments, sell packages, memberships, and retail products
Staff Management - View schedules, manage appointments, track availability
Multi-Location Support - Manage multiple studio locations seamlessly
High Performance - Built on Bun runtime with intelligent caching
Type-Safe - Full TypeScript support with comprehensive types
Dual Transport Support - STDIO for local development, SSE for production deployment

🚀 Quick Start

Installation with npx (Node.js)

# Run directly without installation
npx @vespo92/mindbody-mcp

# Or install globally
npm install -g @vespo92/mindbody-mcp

Installation with bunx (Bun - 4x faster)

# Run directly without installation  
bunx @vespo92/mindbody-mcp

# Or install globally with Bun
bun install -g @vespo92/mindbody-mcp

Install from GitHub

# Using npx
npx github:vespo92/MindbodyMCP

# Using bunx (recommended for performance)
bunx github:vespo92/MindbodyMCP

# Or clone and run locally
git clone https://github.com/vespo92/MindbodyMCP.git
cd MindbodyMCP
bun install # or npm install
bun run start # or npm start

📋 Prerequisites

Node.js 18+ or Bun 1.0+
Mindbody API credentials (API Key, Site ID, Source credentials)
Claude Desktop or any MCP-compatible client

⚙️ Configuration

1. Get Mindbody API Credentials

Sign up for a Mindbody Developer Account
Create a new app to get your API credentials
Note your Site ID (use -99 for sandbox testing)

2. Set Environment Variables

Create a .env file in your project root:

# Copy the example file
cp .env.example .env

# Edit with your credentials
MINDBODY_API_KEY=your_api_key_here
MINDBODY_SITE_ID=-99  # Your site ID
MINDBODY_SOURCE_NAME=your_source_name
MINDBODY_SOURCE_PASSWORD=your_source_password

# Optional settings
MINDBODY_API_URL=https://api.mindbodyonline.com/public/v6

在 GitHub 查看完整 README

安装

npx @vespo92/mindbody-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "mindbody": {
      "command": "bunx",
      "args": ["@vespo92/mindbody-mcp"],
      "env": {
        "MINDBODY_API_KEY": "your_api_key",
        "MINDBODY_SITE_ID": "-99",
        "MINDBODY_SOURCE_NAME": "your_source_name",
        "MINDBODY_SOURCE_PASSWORD": "your_source_password"
      }
    }
  }
}