mcp-hydrocoder-vision 0.1.5 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/{INSTALL.md → INSTALL_CN.md} +19 -3
  2. package/INSTALL_EN.md +69 -0
  3. package/README.md +14 -6
  4. package/README_CN.md +14 -6
  5. package/package.json +3 -2
package/{INSTALL.md → INSTALL_CN.md} RENAMED
@@ -32,15 +32,31 @@ npm install -g mcp-hydrocoder-vision
32
32
  }
33
33
  ```
34
34
 
35
- ### 3. 启动 LM Studio
35
+ ### 3. 授权工具权限
36
+
37
+ 在 `~/.claude/settings.json` 中添加以下配置，可避免每次使用工具时手动确认：
38
+
39
+ ```json
40
+ {
41
+ "permissions": {
42
+ "allow": [
43
+ "mcp__mcp-hydrocoder-vision__analyzeImage",
44
+ "mcp__mcp-hydrocoder-vision__extractText",
45
+ "mcp__mcp-hydrocoder-vision__describeForCode"
46
+ ]
47
+ }
48
+ }
49
+ ```
50
+
51
+ ### 4. 启动 LM Studio
36
52
 
37
53
  1. 打开 LM Studio
38
54
  2. 下载并加载 `Qwen3-VL-4B-Instruct` 模型
39
55
  3. 启动本地服务器（默认端口：1234）
40
56
 
41
- ### 4. 验证安装
57
+ ### 5. 验证安装
42
58
 
43
- 在 Claude 中输入 `/image`，应能看到 `analyzeImage`、`extractText`、`describeForCode` 等工具可用。
59
+ 在 Claude Code 窗口中贴入一张截图，输入"识别图像"等一类的文字，会自动调用 MCP 识别内容。
44
60
 
45
61
  ## 常见问题
46
62
 
package/INSTALL_EN.md ADDED
@@ -0,0 +1,69 @@
1
+ # Installation Guide
2
+
3
+ ## Prerequisites
4
+
5
+ - Node.js 18+ installed
6
+ - LM Studio installed and running
7
+
8
+ ## Installation Steps
9
+
10
+ ### 1. Globally Install MCP Package
11
+
12
+ ```bash
13
+ npm install -g mcp-hydrocoder-vision
14
+ ```
15
+
16
+ ### 2. Configure Claude
17
+
18
+ Edit the `~/.claude.json` file in your user directory and add the following configuration:
19
+
20
+ ```json
21
+ {
22
+ "mcpServers": {
23
+ "hydrocoder-vision": {
24
+ "command": "npx",
25
+ "args": ["-y", "mcp-hydrocoder-vision"],
26
+ "env": {
27
+ "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
28
+ "VISION_MODEL": "Qwen3-VL-4B-Instruct"
29
+ }
30
+ }
31
+ }
32
+ }
33
+ ```
34
+
35
+ ### 3. Authorize Tool Permissions
36
+
37
+ Add the following configuration to `~/.claude/settings.json` to avoid manual confirmation for each tool use:
38
+
39
+ ```json
40
+ {
41
+ "permissions": {
42
+ "allow": [
43
+ "mcp__mcp-hydrocoder-vision__analyzeImage",
44
+ "mcp__mcp-hydrocoder-vision__extractText",
45
+ "mcp__mcp-hydrocoder-vision__describeForCode"
46
+ ]
47
+ }
48
+ }
49
+ ```
50
+
51
+ ### 4. Start LM Studio
52
+
53
+ 1. Open LM Studio
54
+ 2. Download and load the `Qwen3-VL-4B-Instruct` model
55
+ 3. Start the local server (default port: 1234)
56
+
57
+ ### 5. Verify Installation
58
+
59
+ Paste a screenshot into the Claude Code window, type text like "recognize image", and the MCP will be automatically invoked to recognize the content.
60
+
61
+ ## Troubleshooting
62
+
63
+ ### Connection Failed
64
+
65
+ Ensure LM Studio is running and the local server is started. Check if the `LM_STUDIO_URL` environment variable is correct.
66
+
67
+ ### No Model Response
68
+
69
+ Ensure the Qwen3-VL-4B-Instruct model is loaded in LM Studio.
package/README.md CHANGED
@@ -18,14 +18,22 @@ A vision-language MCP server that enables Claude Code to analyze images using **
18
18
 
19
19
  ## Installation
20
20
 
21
+ ### 1. Clone the repository
22
+
21
23
  ```bash
22
- # Navigate to the project directory
23
- cd C:\workspace\develop\ccExtensions\mcpHydroVision
24
+ git clone https://github.com/hydroCoderClaud/mcp-hydrocoder-vision.git
25
+ cd mcp-hydrocoder-vision
26
+ ```
24
27
 
25
- # Install dependencies
28
+ ### 2. Install dependencies
29
+
30
+ ```bash
26
31
  npm install
32
+ ```
33
+
34
+ ### 3. Build the project
27
35
 
28
- # Build the project
36
+ ```bash
29
37
  npm run build
30
38
  ```
31
39
 
@@ -45,8 +53,8 @@ Add to your `~/.claude/settings.json`:
45
53
  {
46
54
  "mcpServers": {
47
55
  "hydrocoder-vision": {
48
- "command": "node",
49
- "args": ["C:/workspace/develop/ccExtensions/mcpHydroVision/dist/index.js"],
56
+ "command": "npx",
57
+ "args": ["-y", "mcp-hydrocoder-vision"],
50
58
  "env": {
51
59
  "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
52
60
  "VISION_MODEL": "Qwen3-VL-4B-Instruct"
package/README_CN.md CHANGED
@@ -18,14 +18,22 @@
18
18
 
19
19
  ## 安装步骤
20
20
 
21
+ ### 1. 克隆仓库
22
+
21
23
  ```bash
22
- # 进入项目目录
23
- cd C:\workspace\develop\ccExtensions\mcpHydroVision
24
+ git clone https://github.com/hydroCoderClaud/mcp-hydrocoder-vision.git
25
+ cd mcp-hydrocoder-vision
26
+ ```
24
27
 
25
- # 安装依赖
28
+ ### 2. 安装依赖
29
+
30
+ ```bash
26
31
  npm install
32
+ ```
33
+
34
+ ### 3. 构建项目
27
35
 
28
- # 构建项目
36
+ ```bash
29
37
  npm run build
30
38
  ```
31
39
 
@@ -45,8 +53,8 @@ npm run build
45
53
  {
46
54
  "mcpServers": {
47
55
  "hydrocoder-vision": {
48
- "command": "node",
49
- "args": ["C:/workspace/develop/ccExtensions/mcpHydroVision/dist/index.js"],
56
+ "command": "npx",
57
+ "args": ["-y", "mcp-hydrocoder-vision"],
50
58
  "env": {
51
59
  "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
52
60
  "VISION_MODEL": "Qwen3-VL-4B-Instruct"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-hydrocoder-vision",
3
- "version": "0.1.5",
3
+ "version": "0.2.0",
4
4
  "description": "Vision MCP Server for Claude Code - Qwen3 VL 4B integration",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
@@ -11,7 +11,8 @@
11
11
  "src/",
12
12
  "README.md",
13
13
  "README_CN.md",
14
- "INSTALL.md",
14
+ "INSTALL_EN.md",
15
+ "INSTALL_CN.md",
15
16
  "LICENSE"
16
17
  ],
17
18
  "scripts": {