loading…
Весь каталог
Fancy Control Server
БесплатноНе проверенMCP server for controlling PowerExchange/Fancy Control devices via HTTP. Provides tools like tilt, shock, beep, and various training modes.
Описание
MCP server for controlling PowerExchange/Fancy Control devices via HTTP. Provides tools like tilt, shock, beep, and various training modes.
README
🌐 Language / Langue : English | Français
🇬🇧 English
HTTP Streamable MCP (Model Context Protocol) server for controlling PowerExchange/Fancy Control devices.
Features
| Tool | Description |
|---|---|
device_config |
Check or save device configuration (SSID, password, serial, key) |
tilt |
Check or save device tilt position value |
pet_training_freeze |
PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode (S2Z) - must stay still |
pet_training_fast |
PET TRAINING FAST - Activate Pet Training fast mode (S2F) - faster response |
warning_buzzer |
Enable/disable the warning buzzer |
pet_training |
Pet Training mode (normal/S2) |
sleep_deprivation |
Sleep Deprivation mode |
random_mode |
Random mode - random activation |
timer |
Timer mode (on/off, get, t1_up/t1_down, t2_up/t2_down) |
beep |
Send a beep (short press equivalent) |
shock |
Send a shock with power 1-100% (long press equivalent) |
power_control |
Power level control |
send_raw_command |
Raw HTTP command for advanced users |
Architecture
MCP Client ──────► Raspberry Pi ──────► Fancy Device
eth0 (Ethernet) wlan0 (WiFi)
Port 8000 Port 80
Quick Start
On Raspberry Pi (ARM64) with Docker
git clone <repository-url>
cd fancy-mcp-server
# Build the image
docker build -t fancy-mcp-server .
# Run the container
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=your-secure-token \
-e DEVICE_IP=192.168.4.1 \
-e DEVICE_PORT=80 \
-e MCP_CONTEXT_DESCRIPTION="My Fancy device" \
fancy-mcp-server
With docker-compose
git clone <repository-url>
cd fancy-mcp-server
cp .env.example .env
# Edit .env with your settings
docker compose up -d
See RASPBERRY_PI_SETUP.md for complete WiFi configuration.
Without Docker (Python)
pip install -r requirements.txt
export MCP_AUTH_TOKEN=your-token
export DEVICE_IP=192.168.4.1
python server.py
Environment Variables
Basic Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
MCP_AUTH_TOKEN |
Yes | - | MCP authentication token |
DEVICE_IP |
Yes | - | Device IP address |
DEVICE_PORT |
No | 80 | Device HTTP port |
MCP_CONTEXT_DESCRIPTION |
No | - | Prefix added to all descriptions |
PORT |
No | 8000 | MCP server port |
MCP_SAFETY_MAX_POWER_0_100 |
No | - | Safety: Maximum power limit (0-100). If set, all power commands (shock, power_control) will be capped at this value |
Tool Descriptions (customizable)
Each tool has its own variable to customize its description:
| Variable | Default Description |
|---|---|
TOOL_DESC_DEVICE_CONFIG |
Device Config - Check or save device configuration... |
TOOL_DESC_TILT |
Tilt - Check or save the device tilt position value |
TOOL_DESC_PET_TRAINING_FREEZE |
PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode... |
TOOL_DESC_PET_TRAINING_FAST |
PET TRAINING FAST - Activate Pet Training fast mode... |
TOOL_DESC_WARNING_BUZZER |
Warning Buzzer - Enable or disable the warning buzzer... |
TOOL_DESC_PET_TRAINING |
Pet Training Mode - Enable or disable pet training... |
TOOL_DESC_SLEEP_DEPRIVATION |
Sleep Deprivation Mode - Enable or disable... |
TOOL_DESC_RANDOM_MODE |
Random Mode - Enable or disable random activation... |
TOOL_DESC_TIMER |
Timer Mode - Enable or disable timer mode... |
TOOL_DESC_BEEP |
Beep - Send a beep signal to the device... |
TOOL_DESC_SHOCK |
Shock - Send a shock signal with specified power... |
TOOL_DESC_POWER_CONTROL |
Power Control - Adjust the device power level |
TOOL_DESC_SEND_RAW_COMMAND |
Send a raw HTTP command to the device... |
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/mcp |
POST | Main MCP endpoint (JSON-RPC) |
/health |
GET | Health check |
/ |
GET | Server info |
Authentication
The server accepts the token with or without "Bearer" prefix:
# With Bearer
-H "Authorization: Bearer your-token"
# Without Bearer
-H "Authorization: your-token"
Usage Examples
Health Check
curl http://192.168.1.100:8000/health
List Tools
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'
Send a Beep
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "beep", "arguments": {}}}'
Shock at 50% Power
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "shock", "arguments": {"power": 50}}}'
Enable Pet Training Freeze
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "pet_training_freeze", "arguments": {"action": "on"}}}'
Enable Timer Mode
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "on"}}}'
Get Timer Values
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "get"}}}'
Increase Timer 1
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: your-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "t1_up"}}}'
Device Endpoints
| Function | Endpoint |
|---|---|
| Device Config Check | /TX? |
| Device Config Save | /TX?SSIDX=<ssid>&PASSX=<password> |
| Tilt Check | /DIS/BOW |
| Tilt Save | /TX?TILTVAL=<value> |
| Pet Training Freeze ON | /mode/S2Z |
| Pet Training Freeze OFF | /mode/0 |
| Pet Training Fast ON | /mode/S2F |
| Pet Training Fast OFF | /mode/0 |
| Buzzer ON | /S1/1 |
| Buzzer OFF | /S1/0 |
| Pet Training | /mode/S2 |
| Sleep Deprivation | /mode/S4 |
| Random | /mode/RN |
| Timer Mode | /mode/TM |
| Timer Get | /DIS/TM |
| Timer 1 + | /T1/+ |
| Timer 1 - | /T1/- |
| Timer 2 + | /T2/+ |
| Timer 2 - | /T2/- |
| Mode OFF | /mode/0 |
| Beep | /B1/1 |
| Shock | /Z1/1 |
| Power + | /PW/+ |
| Power - | /PW/- |
Docker
Build
docker build -t fancy-mcp-server .
Run (minimal config)
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=your-token \
-e DEVICE_IP=192.168.4.1 \
fancy-mcp-server
Run (full config with custom descriptions)
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=your-token \
-e DEVICE_IP=192.168.4.1 \
-e DEVICE_PORT=80 \
-e MCP_CONTEXT_DESCRIPTION="My Device" \
-e MCP_SAFETY_MAX_POWER_0_100=50 \
-e TOOL_DESC_DEVICE_CONFIG="Device config" \
-e TOOL_DESC_TILT="Tilt" \
-e TOOL_DESC_PET_TRAINING_FREEZE="Freeze training mode" \
-e TOOL_DESC_PET_TRAINING_FAST="Fast training mode" \
-e TOOL_DESC_WARNING_BUZZER="Warning buzzer" \
-e TOOL_DESC_PET_TRAINING="Training mode" \
-e TOOL_DESC_SLEEP_DEPRIVATION="Sleep deprivation mode" \
-e TOOL_DESC_RANDOM_MODE="Random mode" \
-e TOOL_DESC_TIMER="Timer" \
-e TOOL_DESC_BEEP="Send a beep" \
-e TOOL_DESC_SHOCK="Send a shock" \
-e TOOL_DESC_POWER_CONTROL="Power control" \
-e TOOL_DESC_SEND_RAW_COMMAND="Raw command" \
fancy-mcp-server
Safety Note: The
MCP_SAFETY_MAX_POWER_0_100variable limits the maximum power. In the example above, even if a shock is requested at 100%, it will be limited to 50%.
Stop / Remove
docker stop fancy-mcp-server
docker rm fancy-mcp-server
Logs
docker logs -f fancy-mcp-server
With docker-compose
docker compose build
docker compose up -d
docker compose logs -f
MCP Compliance
- Protocol Version: 2024-11-05
- Transport: HTTP Streamable
- Format: JSON-RPC 2.0
- Methods: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, ping
🇫🇷 Français
Serveur MCP (Model Context Protocol) HTTP Streamable pour contrôler les appareils PowerExchange/Fancy Control.
Fonctionnalités
| Outil | Description |
|---|---|
device_config |
Vérifie ou sauvegarde la configuration du device (SSID, mot de passe, numéro de série, clé) |
tilt |
Vérifie ou sauvegarde la valeur de position d'inclinaison du device |
pet_training_freeze |
PET TRAINING FREEZE (BETA) - Active le mode Pet Training freeze (S2Z) - doit rester immobile |
pet_training_fast |
PET TRAINING FAST - Active le mode Pet Training rapide (S2F) - réponse plus rapide |
warning_buzzer |
Active/désactive le buzzer d'avertissement |
pet_training |
Mode Pet Training (normal/S2) |
sleep_deprivation |
Mode Sleep Deprivation |
random_mode |
Mode Random - activation aléatoire |
timer |
Mode Timer (on/off, get, t1_up/t1_down, t2_up/t2_down) |
beep |
Envoie un bip (équivalent appui court) |
shock |
Envoie un shock avec puissance 1-100% (équivalent appui long) |
power_control |
Contrôle du niveau de puissance |
send_raw_command |
Commande HTTP brute pour utilisateurs avancés |
Architecture
Client MCP ──────► Raspberry Pi ──────► Device Fancy
eth0 (Ethernet) wlan0 (WiFi)
Port 8000 Port 80
Installation rapide
Sur Raspberry Pi (ARM64) avec Docker
git clone <repository-url>
cd fancy-mcp-server
# Build de l'image
docker build -t fancy-mcp-server .
# Lancer le container
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=votre-token-securise \
-e DEVICE_IP=192.168.4.1 \
-e DEVICE_PORT=80 \
-e MCP_CONTEXT_DESCRIPTION="Mon device Fancy" \
fancy-mcp-server
Avec docker-compose
git clone <repository-url>
cd fancy-mcp-server
cp .env.example .env
# Éditer .env avec vos paramètres
docker compose up -d
Voir RASPBERRY_PI_SETUP.md pour la configuration WiFi complète.
Sans Docker (Python)
pip install -r requirements.txt
export MCP_AUTH_TOKEN=votre-token
export DEVICE_IP=192.168.4.1
python server.py
Variables d'environnement
Configuration de base
| Variable | Requis | Défaut | Description |
|---|---|---|---|
MCP_AUTH_TOKEN |
Oui | - | Token d'authentification MCP |
DEVICE_IP |
Oui | - | Adresse IP du device |
DEVICE_PORT |
Non | 80 | Port HTTP du device |
MCP_CONTEXT_DESCRIPTION |
Non | - | Préfixe ajouté à toutes les descriptions |
PORT |
Non | 8000 | Port du serveur MCP |
MCP_SAFETY_MAX_POWER_0_100 |
Non | - | Sécurité : Limite maximale de puissance (0-100). Si définie, toutes les commandes de puissance (shock, power_control) seront plafonnées à cette valeur |
Descriptions des outils (personnalisables)
Chaque outil a sa propre variable pour personnaliser sa description :
| Variable | Description par défaut |
|---|---|
TOOL_DESC_DEVICE_CONFIG |
Device Config - Check or save device configuration... |
TOOL_DESC_TILT |
Tilt - Check or save the device tilt position value |
TOOL_DESC_PET_TRAINING_FREEZE |
PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode... |
TOOL_DESC_PET_TRAINING_FAST |
PET TRAINING FAST - Activate Pet Training fast mode... |
TOOL_DESC_WARNING_BUZZER |
Warning Buzzer - Enable or disable the warning buzzer... |
TOOL_DESC_PET_TRAINING |
Pet Training Mode - Enable or disable pet training... |
TOOL_DESC_SLEEP_DEPRIVATION |
Sleep Deprivation Mode - Enable or disable... |
TOOL_DESC_RANDOM_MODE |
Random Mode - Enable or disable random activation... |
TOOL_DESC_TIMER |
Timer Mode - Enable or disable timer mode... |
TOOL_DESC_BEEP |
Beep - Send a beep signal to the device... |
TOOL_DESC_SHOCK |
Shock - Send a shock signal with specified power... |
TOOL_DESC_POWER_CONTROL |
Power Control - Adjust the device power level |
TOOL_DESC_SEND_RAW_COMMAND |
Send a raw HTTP command to the device... |
Endpoints API
| Endpoint | Méthode | Description |
|---|---|---|
/mcp |
POST | Endpoint MCP principal (JSON-RPC) |
/health |
GET | Health check |
/ |
GET | Info serveur |
Authentification
Le serveur accepte le token avec ou sans préfixe "Bearer" :
# Avec Bearer
-H "Authorization: Bearer votre-token"
# Sans Bearer
-H "Authorization: votre-token"
Exemples d'utilisation
Health Check
curl http://192.168.1.100:8000/health
Liste des outils
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'
Envoyer un Beep
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "beep", "arguments": {}}}'
Shock à 50% de puissance
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "shock", "arguments": {"power": 50}}}'
Activer Pet Training Freeze
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "pet_training_freeze", "arguments": {"action": "on"}}}'
Activer le mode Timer
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "on"}}}'
Lire les valeurs Timer
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "get"}}}'
Augmenter Timer 1
curl -X POST http://192.168.1.100:8000/mcp \
-H "Content-Type: application/json" \
-H "Authorization: votre-token" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "t1_up"}}}'
Endpoints du Device
| Fonction | Endpoint |
|---|---|
| Config Device (check) | /TX? |
| Config Device (save) | /TX?SSIDX=<ssid>&PASSX=<password> |
| Tilt (check) | /DIS/BOW |
| Tilt (save) | /TX?TILTVAL=<valeur> |
| Pet Training Freeze ON | /mode/S2Z |
| Pet Training Freeze OFF | /mode/0 |
| Pet Training Fast ON | /mode/S2F |
| Pet Training Fast OFF | /mode/0 |
| Buzzer ON | /S1/1 |
| Buzzer OFF | /S1/0 |
| Pet Training | /mode/S2 |
| Sleep Deprivation | /mode/S4 |
| Random | /mode/RN |
| Timer Mode | /mode/TM |
| Timer Get | /DIS/TM |
| Timer 1 + | /T1/+ |
| Timer 1 - | /T1/- |
| Timer 2 + | /T2/+ |
| Timer 2 - | /T2/- |
| Mode OFF | /mode/0 |
| Beep | /B1/1 |
| Shock | /Z1/1 |
| Power + | /PW/+ |
| Power - | /PW/- |
Docker
Build
docker build -t fancy-mcp-server .
Lancer (config minimale)
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=votre-token \
-e DEVICE_IP=192.168.4.1 \
fancy-mcp-server
Lancer (config complète avec descriptions personnalisées)
docker run -d \
--name fancy-mcp-server \
--restart unless-stopped \
-p 8000:8000 \
-e MCP_AUTH_TOKEN=votre-token \
-e DEVICE_IP=192.168.4.1 \
-e DEVICE_PORT=80 \
-e MCP_CONTEXT_DESCRIPTION="Mon Device" \
-e MCP_SAFETY_MAX_POWER_0_100=50 \
-e TOOL_DESC_DEVICE_CONFIG="Configuration device" \
-e TOOL_DESC_TILT="Inclinaison" \
-e TOOL_DESC_PET_TRAINING_FREEZE="Mode dressage freeze" \
-e TOOL_DESC_PET_TRAINING_FAST="Mode dressage rapide" \
-e TOOL_DESC_WARNING_BUZZER="Buzzer d'avertissement" \
-e TOOL_DESC_PET_TRAINING="Mode dressage" \
-e TOOL_DESC_SLEEP_DEPRIVATION="Mode privation de sommeil" \
-e TOOL_DESC_RANDOM_MODE="Mode aléatoire" \
-e TOOL_DESC_TIMER="Minuterie" \
-e TOOL_DESC_BEEP="Émettre un bip" \
-e TOOL_DESC_SHOCK="Envoyer une décharge" \
-e TOOL_DESC_POWER_CONTROL="Contrôle de puissance" \
-e TOOL_DESC_SEND_RAW_COMMAND="Commande brute" \
fancy-mcp-server
Note sécurité : La variable
MCP_SAFETY_MAX_POWER_0_100permet de limiter la puissance maximale. Dans l'exemple ci-dessus, même si un shock est demandé à 100%, il sera limité à 50%.
Arrêter / Supprimer
docker stop fancy-mcp-server
docker rm fancy-mcp-server
Logs
docker logs -f fancy-mcp-server
Avec docker-compose
docker compose build
docker compose up -d
docker compose logs -f
Conformité MCP
- Protocol Version: 2024-11-05
- Transport: HTTP Streamable
- Format: JSON-RPC 2.0
- Méthodes: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, ping
License
MIT License
Как установить
Выполни в терминале:
claude mcp add fancy-control-mcp-server -- npx 
