mcp-hydrocoder-vision 0.1.6 → 0.2.0

package/{INSTALL.md → INSTALL_CN.md}

@@ -32,16 +32,18 @@ npm install -g mcp-hydrocoder-vision
 }
 ```
 
-### 3. 授权工具权限（可选）
+### 3. 授权工具权限
 
 在 `~/.claude/settings.json` 中添加以下配置，可避免每次使用工具时手动确认：
 
 ```json
 {
-  "mcpServerPermissions": {
-    "hydrocoder-vision": {
-      "tools": ["analyzeImage", "extractText", "describeForCode"]
-    }
+  "permissions": {
+    "allow": [
+      "mcp__mcp-hydrocoder-vision__analyzeImage",
+      "mcp__mcp-hydrocoder-vision__extractText",
+      "mcp__mcp-hydrocoder-vision__describeForCode"
+    ]
   }
 }
 ```
@@ -54,7 +56,7 @@ npm install -g mcp-hydrocoder-vision
 
 ### 5. 验证安装
 
-在 Claude 中输入 `/image`，应能看到 `analyzeImage`、`extractText`、`describeForCode` 等工具可用。
+在 Claude Code 窗口中贴入一张截图，输入"识别图像"等一类的文字，会自动调用 MCP 识别内容。
 
 ## 常见问题
 

package/INSTALL_EN.md

@@ -0,0 +1,69 @@
+# Installation Guide
+
+## Prerequisites
+
+- Node.js 18+ installed
+- LM Studio installed and running
+
+## Installation Steps
+
+### 1. Globally Install MCP Package
+
+```bash
+npm install -g mcp-hydrocoder-vision
+```
+
+### 2. Configure Claude
+
+Edit the `~/.claude.json` file in your user directory and add the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "hydrocoder-vision": {
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-vision"],
+      "env": {
+        "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
+        "VISION_MODEL": "Qwen3-VL-4B-Instruct"
+      }
+    }
+  }
+}
+```
+
+### 3. Authorize Tool Permissions
+
+Add the following configuration to `~/.claude/settings.json` to avoid manual confirmation for each tool use:
+
+```json
+{
+  "permissions": {
+    "allow": [
+      "mcp__mcp-hydrocoder-vision__analyzeImage",
+      "mcp__mcp-hydrocoder-vision__extractText",
+      "mcp__mcp-hydrocoder-vision__describeForCode"
+    ]
+  }
+}
+```
+
+### 4. Start LM Studio
+
+1. Open LM Studio
+2. Download and load the `Qwen3-VL-4B-Instruct` model
+3. Start the local server (default port: 1234)
+
+### 5. Verify Installation
+
+Paste a screenshot into the Claude Code window, type text like "recognize image", and the MCP will be automatically invoked to recognize the content.
+
+## Troubleshooting
+
+### Connection Failed
+
+Ensure LM Studio is running and the local server is started. Check if the `LM_STUDIO_URL` environment variable is correct.
+
+### No Model Response
+
+Ensure the Qwen3-VL-4B-Instruct model is loaded in LM Studio.

package/README.md

@@ -18,14 +18,22 @@ A vision-language MCP server that enables Claude Code to analyze images using **
 
 ## Installation
 
+### 1. Clone the repository
+
 ```bash
-# Navigate to the project directory
-cd C:\workspace\develop\ccExtensions\mcpHydroVision
+git clone https://github.com/hydroCoderClaud/mcp-hydrocoder-vision.git
+cd mcp-hydrocoder-vision
+```
 
-# Install dependencies
+### 2. Install dependencies
+
+```bash
 npm install
+```
+
+### 3. Build the project
 
-# Build the project
+```bash
 npm run build
 ```
 
@@ -45,8 +53,8 @@ Add to your `~/.claude/settings.json`:
 {
   "mcpServers": {
     "hydrocoder-vision": {
-      "command": "node",
-      "args": ["C:/workspace/develop/ccExtensions/mcpHydroVision/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-vision"],
       "env": {
         "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
         "VISION_MODEL": "Qwen3-VL-4B-Instruct"

package/README_CN.md

@@ -18,14 +18,22 @@
 
 ## 安装步骤
 
+### 1. 克隆仓库
+
 ```bash
-# 进入项目目录
-cd C:\workspace\develop\ccExtensions\mcpHydroVision
+git clone https://github.com/hydroCoderClaud/mcp-hydrocoder-vision.git
+cd mcp-hydrocoder-vision
+```
 
-# 安装依赖
+### 2. 安装依赖
+
+```bash
 npm install
+```
+
+### 3. 构建项目
 
-# 构建项目
+```bash
 npm run build
 ```
 
@@ -45,8 +53,8 @@ npm run build
 {
   "mcpServers": {
     "hydrocoder-vision": {
-      "command": "node",
-      "args": ["C:/workspace/develop/ccExtensions/mcpHydroVision/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-vision"],
       "env": {
         "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
         "VISION_MODEL": "Qwen3-VL-4B-Instruct"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-hydrocoder-vision",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Vision MCP Server for Claude Code - Qwen3 VL 4B integration",
   "type": "module",
   "main": "src/index.ts",
@@ -11,7 +11,8 @@
     "src/",
     "README.md",
     "README_CN.md",
-    "INSTALL.md",
+    "INSTALL_EN.md",
+    "INSTALL_CN.md",
     "LICENSE"
   ],
   "scripts": {