@goonnguyen/human-mcp 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.2.1](https://github.com/mrgoonie/human-mcp/compare/v1.2.0...v1.2.1) (2025-09-08)
+
+
+### Bug Fixes
+
+* update tool names to comply with MCP validation pattern ([3c23e10](https://github.com/mrgoonie/human-mcp/commit/3c23e101e843095fb33703dd9431a89936c18308))
+
 # [1.2.0](https://github.com/mrgoonie/human-mcp/compare/v1.1.0...v1.2.0) (2025-09-08)
 
 

package/CLAUDE.md

@@ -38,7 +38,7 @@ src/
 ### Key Components
 
 **Vision Analysis (tools/eyes/)**
-- `index.ts` - Registers eyes.analyze and eyes.compare tools
+- `index.ts` - Registers eyes_analyze and eyes_compare tools
 - `processors/` - Handles image, video, and GIF processing
 - `utils/gemini-client.ts` - Google Gemini API integration
 - `schemas.ts` - Zod validation schemas for tool inputs
@@ -50,14 +50,16 @@ src/
 
 ## MCP Tools
 
-### eyes.analyze
+**Important**: Tool names must comply with MCP validation pattern `^[a-zA-Z0-9_-]{1,64}$`. Only alphanumeric characters, underscores, and hyphens are allowed. No dots, spaces, or other special characters.
+
+### eyes_analyze
 Primary tool for visual analysis of images, videos, and GIFs:
 - Supports file paths, URLs, and base64 data URIs
 - Configurable detail levels (quick/detailed)
 - Frame extraction for videos and GIFs
 - Custom analysis prompts
 
-### eyes.compare  
+### eyes_compare  
 Compares two images to identify visual differences:
 - Three comparison types: pixel, structural, semantic
 - Detailed difference reporting

package/QUICKSTART.md

@@ -61,7 +61,7 @@ Human MCP should analyze the image and provide detailed debugging insights!
 
 ### Debug UI Issues
 ```
-Use the eyes.analyze tool with this screenshot:
+Use the eyes_analyze tool with this screenshot:
 - Type: image
 - Analysis type: ui_debug  
 - Detail level: detailed
@@ -69,7 +69,7 @@ Use the eyes.analyze tool with this screenshot:
 
 ### Analyze Error Recordings
 ```
-Use the eyes.analyze tool with this screen recording:
+Use the eyes_analyze tool with this screen recording:
 - Type: video
 - Analysis type: error_detection
 - Focus on: the error sequence
@@ -77,7 +77,7 @@ Use the eyes.analyze tool with this screen recording:
 
 ### Check Accessibility
 ```
-Use the eyes.analyze tool:
+Use the eyes_analyze tool:
 - Analysis type: accessibility
 - Check accessibility: true
 ```

package/README.md

@@ -144,7 +144,7 @@ Claude Desktop is a desktop application that provides a user-friendly interface
 
 **Verification:**
 - Look for the connection indicator in Claude Desktop
-- Try using the `eyes.analyze` tool with a test image
+- Try using the `eyes_analyze` tool with a test image
 
 #### Claude Code (CLI)
 
@@ -413,7 +413,7 @@ cd /path/to/human-mcp && bun run inspector
 
 **Test with MCP Clients:**
 1. Check client logs for connection status
-2. Try using `eyes.analyze` tool with a test image
+2. Try using `eyes_analyze` tool with a test image
 3. Verify API responses are returned correctly
 4. Look for the Human MCP server in the client's MCP server list
 
@@ -471,7 +471,7 @@ human-mcp --version  # if globally installed
 
 ## Tools
 
-### eyes.analyze
+### eyes_analyze
 
 Comprehensive visual analysis for images, videos, and GIFs.
 
@@ -485,7 +485,7 @@ Comprehensive visual analysis for images, videos, and GIFs.
 }
 ```
 
-### eyes.compare
+### eyes_compare
 
 Compare two images to identify visual differences.
 

package/dist/index.js

@@ -48723,7 +48723,7 @@ var CompareInputSchema = exports_external.object({
 // src/tools/eyes/index.ts
 async function registerEyesTool(server, config) {
   const geminiClient = new GeminiClient(config);
-  server.registerTool("eyes.analyze", {
+  server.registerTool("eyes_analyze", {
     title: "Vision Analysis Tool",
     description: "Analyze images, videos, and GIFs using AI vision capabilities",
     inputSchema: {
@@ -48738,7 +48738,7 @@ async function registerEyesTool(server, config) {
       return await handleAnalyze(geminiClient, args, config);
     } catch (error) {
       const mcpError = handleError(error);
-      logger.error(`Tool eyes.analyze error:`, mcpError);
+      logger.error(`Tool eyes_analyze error:`, mcpError);
       return {
         content: [{
           type: "text",
@@ -48748,7 +48748,7 @@ async function registerEyesTool(server, config) {
       };
     }
   });
-  server.registerTool("eyes.compare", {
+  server.registerTool("eyes_compare", {
     title: "Image Comparison Tool",
     description: "Compare two images and identify differences",
     inputSchema: {
@@ -48761,7 +48761,7 @@ async function registerEyesTool(server, config) {
       return await handleCompare(geminiClient, args);
     } catch (error) {
       const mcpError = handleError(error);
-      logger.error(`Tool eyes.compare error:`, mcpError);
+      logger.error(`Tool eyes_compare error:`, mcpError);
       return {
         content: [{
           type: "text",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goonnguyen/human-mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Human MCP: Bringing Human Capabilities to Coding Agents",
   "type": "module",
   "main": "dist/index.js",

package/src/tools/eyes/index.ts

@@ -17,9 +17,9 @@ import type { Config } from "@/utils/config.js";
 export async function registerEyesTool(server: McpServer, config: Config) {
   const geminiClient = new GeminiClient(config);
   
-  // Register eyes.analyze tool
+  // Register eyes_analyze tool
   server.registerTool(
-    "eyes.analyze",
+    "eyes_analyze",
     {
       title: "Vision Analysis Tool",
       description: "Analyze images, videos, and GIFs using AI vision capabilities",
@@ -36,7 +36,7 @@ export async function registerEyesTool(server: McpServer, config: Config) {
         return await handleAnalyze(geminiClient, args, config);
       } catch (error) {
         const mcpError = handleError(error);
-        logger.error(`Tool eyes.analyze error:`, mcpError);
+        logger.error(`Tool eyes_analyze error:`, mcpError);
         
         return {
           content: [{
@@ -49,9 +49,9 @@ export async function registerEyesTool(server: McpServer, config: Config) {
     }
   );
 
-  // Register eyes.compare tool
+  // Register eyes_compare tool
   server.registerTool(
-    "eyes.compare",
+    "eyes_compare",
     {
       title: "Image Comparison Tool", 
       description: "Compare two images and identify differences",
@@ -66,7 +66,7 @@ export async function registerEyesTool(server: McpServer, config: Config) {
         return await handleCompare(geminiClient, args);
       } catch (error) {
         const mcpError = handleError(error);
-        logger.error(`Tool eyes.compare error:`, mcpError);
+        logger.error(`Tool eyes_compare error:`, mcpError);
         
         return {
           content: [{