mcp-hydrocoder-vision 0.1.2 → 0.1.3
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.
- package/INSTALL.md +79 -0
- package/package.json +2 -1
package/INSTALL.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
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 Desktop（ graphical 界面）
|
|
27
|
+
|
|
28
|
+
打开 Claude Desktop，进入 **Settings** → **Developer** → **Edit Settings**，将以下配置添加到 `~/.claude/settings.json`（或 `~/.claude.json`）中：
|
|
29
|
+
|
|
30
|
+
```json
|
|
31
|
+
{
|
|
32
|
+
"mcpServers": {
|
|
33
|
+
"hydrocoder-vision": {
|
|
34
|
+
"command": "npx",
|
|
35
|
+
"args": ["-y", "mcp-hydrocoder-vision"],
|
|
36
|
+
"env": {
|
|
37
|
+
"LM_STUDIO_URL": "http://localhost:1234/v1/chat/completions",
|
|
38
|
+
"VISION_MODEL": "Qwen3-VL-4B-Instruct"
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
#### 方式二：Claude 命令行
|
|
46
|
+
|
|
47
|
+
在终端中运行以下命令：
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
claude --editing --settings '{"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"}}}}'
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
如果需要指定配置文件路径：
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
claude --editing --settings-file ~/.claude/settings.json
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
然后手动将配置内容添加到文件中。
|
|
60
|
+
|
|
61
|
+
### 3. 启动 LM Studio
|
|
62
|
+
|
|
63
|
+
1. 打开 LM Studio
|
|
64
|
+
2. 下载并加载 `Qwen3-VL-4B-Instruct` 模型
|
|
65
|
+
3. 启动本地服务器（默认端口：1234）
|
|
66
|
+
|
|
67
|
+
### 4. 验证安装
|
|
68
|
+
|
|
69
|
+
在 Claude 中输入 `/image`，应能看到 `analyzeImage`、`extractText`、`describeForCode` 等工具可用。
|
|
70
|
+
|
|
71
|
+
## 常见问题
|
|
72
|
+
|
|
73
|
+
### 连接失败
|
|
74
|
+
|
|
75
|
+
确保 LM Studio 正在运行且本地服务器已启动。检查 `LM_STUDIO_URL` 环境变量是否正确。
|
|
76
|
+
|
|
77
|
+
### 模型未响应
|
|
78
|
+
|
|
79
|
+
确认 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.
|
|
3
|
+
"version": "0.1.3",
|
|
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": {
|