Accept string-typed numeric parameters in tool schemas

Author: es617

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.1.2
+
+### Fixed
+- Accept string-typed numeric parameters in tool schemas (`"4"` instead of `4`). Some MCP clients serialize all tool arguments as strings, which caused JSON Schema validation errors on `integer` and `number` fields. Affected fields: `handle`, `max_items`, `timeout_s`, `idle_timeout_s`, `k`, `n`.
+
 ## 0.1.1
 
 - Add MCP registry metadata (server.json)

ble_mcp_server/handlers_ble.py

@@ -58,7 +58,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
             "type": "object",
             "properties": {
                 "timeout_s": {
-                    "type": "number",
+                    "type": ["number", "string"],
                     "description": "Max scan duration in seconds (default 10, max 60). Scan auto-stops after this.",
                     "default": 10,
                 },
@@ -123,7 +123,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
                     "description": "MAC address or platform identifier of the device.",
                 },
                 "timeout_s": {
-                    "type": "number",
+                    "type": ["number", "string"],
                     "description": "Connection timeout in seconds (default 10).",
                     "default": 10,
                 },
@@ -239,7 +239,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
             "properties": {
                 "connection_id": {"type": "string"},
                 "handle": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "The descriptor handle (integer) from ble.discover.",
                 },
             },
@@ -257,7 +257,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
             "properties": {
                 "connection_id": {"type": "string"},
                 "handle": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "The descriptor handle (integer).",
                 },
                 "value_b64": {"type": "string", "description": "Base64-encoded value."},
@@ -303,7 +303,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
                 "connection_id": {"type": "string"},
                 "subscription_id": {"type": "string"},
                 "timeout_s": {
-                    "type": "number",
+                    "type": ["number", "string"],
                     "description": "Max seconds to wait (default 10, max 60).",
                     "default": 10,
                 },
@@ -324,7 +324,7 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
                 "connection_id": {"type": "string"},
                 "subscription_id": {"type": "string"},
                 "max_items": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "Max notifications to return (default 50, max 1000).",
                     "default": 50,
                 },
@@ -346,17 +346,17 @@ def _decode_value(args: dict[str, Any]) -> bytes | dict[str, Any]:
                 "connection_id": {"type": "string"},
                 "subscription_id": {"type": "string"},
                 "timeout_s": {
-                    "type": "number",
+                    "type": ["number", "string"],
                     "description": "Total max wait in seconds (default 2, max 60).",
                     "default": 2,
                 },
                 "idle_timeout_s": {
-                    "type": "number",
+                    "type": ["number", "string"],
                     "description": "Max idle gap between notifications before stopping (default 0.25, max 10).",
                     "default": 0.25,
                 },
                 "max_items": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "Max notifications to collect (default 200, max 5000).",
                     "default": 200,
                 },

ble_mcp_server/handlers_spec.py

@@ -113,7 +113,7 @@
                 "spec_id": {"type": "string"},
                 "query": {"type": "string", "description": "Search terms (space-separated)."},
                 "k": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "Max results to return (default 10).",
                     "default": 10,
                 },

ble_mcp_server/handlers_trace.py

@@ -31,7 +31,7 @@
             "type": "object",
             "properties": {
                 "n": {
-                    "type": "integer",
+                    "type": ["integer", "string"],
                     "description": "Number of recent events to return (default 50).",
                     "default": 50,
                 },

server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/es617/ble-mcp-server.git",
     "source": "github"
   },
-  "version": "0.1.1",
+  "version": "0.1.2",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "ble-mcp-server",
-      "version": "0.1.1",
+      "version": "0.1.2",
       "transport": {
         "type": "stdio"
       },