mcp-hydrocoder-vision 0.1.2 → 0.1.4

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 (2) hide show
  1. package/INSTALL.md +61 -0
  2. package/package.json +2 -1
package/INSTALL.md ADDED
@@ -0,0 +1,61 @@
1
+ # 安装说明
2
+
3
+ ## 前置要求
4
+
5
+ - Node.js 18+ 已安装
6
+ - LM Studio 已安装并运行
7
+
8
+ ## 安装步骤
9
+
10
+ ### 1. 安装 MCP 包
11
+
12
+ 全局安装:
13
+
14
+ ```bash
15
+ npm install -g mcp-hydrocoder-vision
16
+ ```
17
+
18
+ 或者使用 npx(无需全局安装):
19
+
20
+ ```bash
21
+ npx -y mcp-hydrocoder-vision
22
+ ```
23
+
24
+ ### 2. 配置 Claude
25
+
26
+ 编辑用户目录下的 `~/.claude.json` 文件,添加以下配置:
27
+
28
+ ```json
29
+ {
30
+ "mcpServers": {
31
+ "hydrocoder-vision": {
32
+ "command": "npx",
33
+ "args": ["-y", "mcp-hydrocoder-vision"],
34
+ "env": {
35
+ "LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
36
+ "VISION_MODEL": "Qwen3-VL-4B-Instruct"
37
+ }
38
+ }
39
+ }
40
+ }
41
+ ```
42
+
43
+ ### 3. 启动 LM Studio
44
+
45
+ 1. 打开 LM Studio
46
+ 2. 下载并加载 `Qwen3-VL-4B-Instruct` 模型
47
+ 3. 启动本地服务器(默认端口:1234)
48
+
49
+ ### 4. 验证安装
50
+
51
+ 在 Claude 中输入 `/image`,应能看到 `analyzeImage`、`extractText`、`describeForCode` 等工具可用。
52
+
53
+ ## 常见问题
54
+
55
+ ### 连接失败
56
+
57
+ 确保 LM Studio 正在运行且本地服务器已启动。检查 `LM_STUDIO_URL` 环境变量是否正确。
58
+
59
+ ### 模型未响应
60
+
61
+ 确认 Qwen3-VL-4B-Instruct 模型已加载到 LM Studio。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcp-hydrocoder-vision",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "description": "Vision MCP Server for Claude Code - Qwen3 VL 4B integration",
5
5
  "type": "module",
6
6
  "main": "src/index.ts",
@@ -11,6 +11,7 @@
11
11
  "src/",
12
12
  "README.md",
13
13
  "README_CN.md",
14
+ "INSTALL.md",
14
15
  "LICENSE"
15
16
  ],
16
17
  "scripts": {