stackchan-mcp 0.1.0__tar.gz → 0.2.0__tar.gz

{stackchan_mcp-0.1.0 → stackchan_mcp-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackchan-mcp
-Version: 0.1.0
+Version: 0.2.0
 Summary: Two-faced MCP gateway for StackChan (xiaozhi-esp32): bridges stdio MCP clients to the ESP32 over WebSocket + HTTP.
 Project-URL: Homepage, https://github.com/kisaragi-mochi/stackchan-mcp
 Project-URL: Repository, https://github.com/kisaragi-mochi/stackchan-mcp
@@ -163,7 +163,7 @@ Same shape, under `mcpServers`.
 | `move_head(yaw, pitch, speed?)` | Drive yaw + pitch servos |
 | `get_head_angles` | Read current yaw + pitch servo angles |
 | `get_touch_state` | Touch sensor state (press/release/stroke) |
-| `set_avatar(face)` | Switch avatar expression (`idle` / `happy` / `thinking` / `sad` / `surprised` / `embarrassed`) |
+| `set_avatar(face)` | Switch avatar expression (`idle` / `happy` / `thinking` / `sad` / `surprised` / `embarrassed`), or `off` to hide the avatar and disable blink so the underlying xiaozhi-esp32 screens (WiFi config UI, OTA, settings) are visible. A subsequent `set_avatar(<other face>)` brings it back and restores blink. |
 | `set_blink(state)` | Blink animation on/off |
 | `set_mouth(state)` | Mouth shape (`closed` / `half` / `open` / `e` / `u`) |
 | `check_vm_en` | Read PY32 VM EN GPIO state (servo power supply diagnostic) |

{stackchan_mcp-0.1.0 → stackchan_mcp-0.2.0}/README.md

@@ -132,7 +132,7 @@ Same shape, under `mcpServers`.
 | `move_head(yaw, pitch, speed?)` | Drive yaw + pitch servos |
 | `get_head_angles` | Read current yaw + pitch servo angles |
 | `get_touch_state` | Touch sensor state (press/release/stroke) |
-| `set_avatar(face)` | Switch avatar expression (`idle` / `happy` / `thinking` / `sad` / `surprised` / `embarrassed`) |
+| `set_avatar(face)` | Switch avatar expression (`idle` / `happy` / `thinking` / `sad` / `surprised` / `embarrassed`), or `off` to hide the avatar and disable blink so the underlying xiaozhi-esp32 screens (WiFi config UI, OTA, settings) are visible. A subsequent `set_avatar(<other face>)` brings it back and restores blink. |
 | `set_blink(state)` | Blink animation on/off |
 | `set_mouth(state)` | Mouth shape (`closed` / `half` / `open` / `e` / `u`) |
 | `check_vm_en` | Read PY32 VM EN GPIO state (servo power supply diagnostic) |

{stackchan_mcp-0.1.0 → stackchan_mcp-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackchan-mcp"
-version = "0.1.0"
+version = "0.2.0"
 description = "Two-faced MCP gateway for StackChan (xiaozhi-esp32): bridges stdio MCP clients to the ESP32 over WebSocket + HTTP."
 readme = "README.md"
 requires-python = ">=3.10"

{stackchan_mcp-0.1.0 → stackchan_mcp-0.2.0}/stackchan_mcp/stdio_server.py

@@ -150,8 +150,11 @@ def create_server() -> Server:
                 name="set_avatar",
                 description=(
                     "Switch the avatar face shown on the LCD. "
-                    "Pick the face that fits the current emotional beat — this is "
-                    "the robot's actual visible expression, not just a label."
+                    "Choose one of the supported faces; this is the robot's "
+                    "actual visible expression, not just a label. "
+                    "Pass 'off' to hide the avatar and disable blink, exposing the "
+                    "underlying xiaozhi-esp32 screens (WiFi config UI, OTA, settings); "
+                    "any other face brings the avatar back and restores blink."
                 ),
                 inputSchema={
                     "type": "object",
@@ -165,8 +168,12 @@ def create_server() -> Server:
                                 "sad",
                                 "surprised",
                                 "embarrassed",
+                                "off",
                             ],
-                            "description": "One of: idle, happy, thinking, sad, surprised, embarrassed.",
+                            "description": (
+                                "One of: idle, happy, thinking, sad, surprised, "
+                                "embarrassed, off."
+                            ),
                         },
                     },
                     "required": ["face"],

{stackchan_mcp-0.1.0 → stackchan_mcp-0.2.0}/uv.lock

@@ -1313,7 +1313,7 @@ wheels = [
 
 [[package]]
 name = "stackchan-mcp"
-version = "0.1.0"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },