visiongemma-mcp 2.1.0__tar.gz
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.
- visiongemma_mcp-2.1.0/PKG-INFO +81 -0
- visiongemma_mcp-2.1.0/README.md +65 -0
- visiongemma_mcp-2.1.0/pyproject.toml +29 -0
- visiongemma_mcp-2.1.0/setup.cfg +4 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp/__init__.py +4 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp/__main__.py +6 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp/launcher.py +69 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp.egg-info/PKG-INFO +81 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp.egg-info/SOURCES.txt +10 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp.egg-info/dependency_links.txt +1 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp.egg-info/entry_points.txt +2 -0
- visiongemma_mcp-2.1.0/src/visiongemma_mcp.egg-info/top_level.txt +1 -0
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: visiongemma-mcp
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: Local AI vision MCP server for Windows: OCR (Chinese & English), chart analysis, scene description, object recognition. 100% offline — images never leave your machine.
|
|
5
|
+
Author: q1023884985
|
|
6
|
+
License: Proprietary
|
|
7
|
+
Keywords: mcp,vision,ocr,llm,computer-vision,local
|
|
8
|
+
Classifier: Development Status :: 4 - Beta
|
|
9
|
+
Classifier: Environment :: Win32 (MS Windows)
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
14
|
+
Requires-Python: >=3.9
|
|
15
|
+
Description-Content-Type: text/markdown
|
|
16
|
+
|
|
17
|
+
# VisionGemma MCP
|
|
18
|
+
|
|
19
|
+
mcp-name: io.github.q1023884985/visiongemma
|
|
20
|
+
|
|
21
|
+
**VisionGemma** is a local AI vision recognition MCP server for Windows. It exposes a single `vision_analyze` tool that lets any MCP client (Claude Desktop, Cursor, Cline, opencode, ...) do:
|
|
22
|
+
|
|
23
|
+
- **OCR** — extract text from images and screenshots (Chinese & English)
|
|
24
|
+
- **Chart / diagram analysis** — interpret tables, plots, diagrams and screenshots
|
|
25
|
+
- **Scene description** — describe what is in an image
|
|
26
|
+
- **Object recognition** — identify objects, people, expressions, atmosphere
|
|
27
|
+
|
|
28
|
+
All inference runs **100% locally** via a Vulkan-accelerated on-device engine. Images never leave your machine.
|
|
29
|
+
|
|
30
|
+
> **Note:** this package is the stdio launcher for the MCP Registry. It requires the VisionGemma engine (Windows x64) to be installed. Download it from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases), then run the installer once.
|
|
31
|
+
|
|
32
|
+
## Installation
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
pip install visiongemma-mcp
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Install the VisionGemma engine from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases) page.
|
|
39
|
+
|
|
40
|
+
## MCP configuration
|
|
41
|
+
|
|
42
|
+
Add to your MCP client config:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"vision-gemma": {
|
|
48
|
+
"command": "visiongemma",
|
|
49
|
+
"args": ["--mcp"],
|
|
50
|
+
"type": "stdio"
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Or point directly at the engine executable (no pip install needed):
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
{
|
|
60
|
+
"mcpServers": {
|
|
61
|
+
"vision-gemma": {
|
|
62
|
+
"command": "C:\\path\\to\\VisionGemma.exe",
|
|
63
|
+
"args": ["--mcp"],
|
|
64
|
+
"type": "stdio"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Tool: vision_analyze
|
|
71
|
+
|
|
72
|
+
| Parameter | Type | Description |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| `image_path` | string (required) | Local absolute path, `http(s)://` URL, or base64 data URI of the image |
|
|
75
|
+
| `prompt` | string (optional) | Question or instruction about the image (default: "please describe this image") |
|
|
76
|
+
|
|
77
|
+
## Privacy & licensing
|
|
78
|
+
|
|
79
|
+
- All processing is local and offline — no data leaves your device.
|
|
80
|
+
- Free 7-day trial; 38 CNY one-time purchase to keep it forever. See in-app activation.
|
|
81
|
+
- Windows 10/11 x64, Vulkan-capable GPU (or CPU fallback).
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# VisionGemma MCP
|
|
2
|
+
|
|
3
|
+
mcp-name: io.github.q1023884985/visiongemma
|
|
4
|
+
|
|
5
|
+
**VisionGemma** is a local AI vision recognition MCP server for Windows. It exposes a single `vision_analyze` tool that lets any MCP client (Claude Desktop, Cursor, Cline, opencode, ...) do:
|
|
6
|
+
|
|
7
|
+
- **OCR** — extract text from images and screenshots (Chinese & English)
|
|
8
|
+
- **Chart / diagram analysis** — interpret tables, plots, diagrams and screenshots
|
|
9
|
+
- **Scene description** — describe what is in an image
|
|
10
|
+
- **Object recognition** — identify objects, people, expressions, atmosphere
|
|
11
|
+
|
|
12
|
+
All inference runs **100% locally** via a Vulkan-accelerated on-device engine. Images never leave your machine.
|
|
13
|
+
|
|
14
|
+
> **Note:** this package is the stdio launcher for the MCP Registry. It requires the VisionGemma engine (Windows x64) to be installed. Download it from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases), then run the installer once.
|
|
15
|
+
|
|
16
|
+
## Installation
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
pip install visiongemma-mcp
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Install the VisionGemma engine from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases) page.
|
|
23
|
+
|
|
24
|
+
## MCP configuration
|
|
25
|
+
|
|
26
|
+
Add to your MCP client config:
|
|
27
|
+
|
|
28
|
+
```json
|
|
29
|
+
{
|
|
30
|
+
"mcpServers": {
|
|
31
|
+
"vision-gemma": {
|
|
32
|
+
"command": "visiongemma",
|
|
33
|
+
"args": ["--mcp"],
|
|
34
|
+
"type": "stdio"
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Or point directly at the engine executable (no pip install needed):
|
|
41
|
+
|
|
42
|
+
```json
|
|
43
|
+
{
|
|
44
|
+
"mcpServers": {
|
|
45
|
+
"vision-gemma": {
|
|
46
|
+
"command": "C:\\path\\to\\VisionGemma.exe",
|
|
47
|
+
"args": ["--mcp"],
|
|
48
|
+
"type": "stdio"
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Tool: vision_analyze
|
|
55
|
+
|
|
56
|
+
| Parameter | Type | Description |
|
|
57
|
+
|---|---|---|
|
|
58
|
+
| `image_path` | string (required) | Local absolute path, `http(s)://` URL, or base64 data URI of the image |
|
|
59
|
+
| `prompt` | string (optional) | Question or instruction about the image (default: "please describe this image") |
|
|
60
|
+
|
|
61
|
+
## Privacy & licensing
|
|
62
|
+
|
|
63
|
+
- All processing is local and offline — no data leaves your device.
|
|
64
|
+
- Free 7-day trial; 38 CNY one-time purchase to keep it forever. See in-app activation.
|
|
65
|
+
- Windows 10/11 x64, Vulkan-capable GPU (or CPU fallback).
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "visiongemma-mcp"
|
|
7
|
+
version = "2.1.0"
|
|
8
|
+
description = "Local AI vision MCP server for Windows: OCR (Chinese & English), chart analysis, scene description, object recognition. 100% offline — images never leave your machine."
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.9"
|
|
11
|
+
license = { text = "Proprietary" }
|
|
12
|
+
authors = [{ name = "q1023884985" }]
|
|
13
|
+
keywords = ["mcp", "vision", "ocr", "llm", "computer-vision", "local"]
|
|
14
|
+
classifiers = [
|
|
15
|
+
"Development Status :: 4 - Beta",
|
|
16
|
+
"Environment :: Win32 (MS Windows)",
|
|
17
|
+
"Intended Audience :: Developers",
|
|
18
|
+
"Operating System :: Microsoft :: Windows",
|
|
19
|
+
"Programming Language :: Python :: 3",
|
|
20
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
21
|
+
]
|
|
22
|
+
dependencies = []
|
|
23
|
+
|
|
24
|
+
[project.scripts]
|
|
25
|
+
visiongemma = "visiongemma_mcp:main"
|
|
26
|
+
|
|
27
|
+
[tool.setuptools.packages.find]
|
|
28
|
+
where = ["src"]
|
|
29
|
+
include = ["visiongemma_mcp*"]
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import os
|
|
2
|
+
import shutil
|
|
3
|
+
import subprocess
|
|
4
|
+
import sys
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def _find_engine() -> str | None:
|
|
8
|
+
candidates = []
|
|
9
|
+
|
|
10
|
+
env = os.environ.get("VISIONGEMMA_EXE")
|
|
11
|
+
if env:
|
|
12
|
+
candidates.append(env)
|
|
13
|
+
|
|
14
|
+
local = os.path.join(os.environ.get("LOCALAPPDATA", ""), "VisionGemma", "VisionGemma.exe")
|
|
15
|
+
candidates.append(local)
|
|
16
|
+
|
|
17
|
+
prog = os.path.join(os.environ.get("PROGRAMFILES", ""), "VisionGemma", "VisionGemma.exe")
|
|
18
|
+
candidates.append(prog)
|
|
19
|
+
|
|
20
|
+
in_path = shutil.which("VisionGemma.exe")
|
|
21
|
+
if in_path:
|
|
22
|
+
candidates.append(in_path)
|
|
23
|
+
|
|
24
|
+
for c in candidates:
|
|
25
|
+
if c and os.path.isfile(c):
|
|
26
|
+
return c
|
|
27
|
+
return None
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def main() -> int:
|
|
31
|
+
exe = _find_engine()
|
|
32
|
+
if exe is None:
|
|
33
|
+
sys.stderr.write(
|
|
34
|
+
"VisionGemma engine not found.\n"
|
|
35
|
+
"Download and install it from https://github.com/q1023884985/visiongemma/releases\n"
|
|
36
|
+
"or set the VISIONGEMMA_EXE environment variable to the VisionGemma.exe path.\n"
|
|
37
|
+
)
|
|
38
|
+
return 1
|
|
39
|
+
|
|
40
|
+
proc = subprocess.Popen(
|
|
41
|
+
[exe, "--mcp"],
|
|
42
|
+
stdin=subprocess.PIPE,
|
|
43
|
+
stdout=subprocess.PIPE,
|
|
44
|
+
stderr=sys.stderr,
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
def pump(src, dst):
|
|
48
|
+
try:
|
|
49
|
+
while True:
|
|
50
|
+
chunk = src.read(4096)
|
|
51
|
+
if not chunk:
|
|
52
|
+
break
|
|
53
|
+
dst.write(chunk)
|
|
54
|
+
dst.flush()
|
|
55
|
+
except Exception:
|
|
56
|
+
pass
|
|
57
|
+
|
|
58
|
+
import threading
|
|
59
|
+
|
|
60
|
+
t1 = threading.Thread(target=pump, args=(sys.stdin.buffer, proc.stdin), daemon=True)
|
|
61
|
+
t2 = threading.Thread(target=pump, args=(proc.stdout, sys.stdout.buffer), daemon=True)
|
|
62
|
+
t1.start()
|
|
63
|
+
t2.start()
|
|
64
|
+
proc.wait()
|
|
65
|
+
return proc.returncode
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
if __name__ == "__main__":
|
|
69
|
+
sys.exit(main())
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: visiongemma-mcp
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: Local AI vision MCP server for Windows: OCR (Chinese & English), chart analysis, scene description, object recognition. 100% offline — images never leave your machine.
|
|
5
|
+
Author: q1023884985
|
|
6
|
+
License: Proprietary
|
|
7
|
+
Keywords: mcp,vision,ocr,llm,computer-vision,local
|
|
8
|
+
Classifier: Development Status :: 4 - Beta
|
|
9
|
+
Classifier: Environment :: Win32 (MS Windows)
|
|
10
|
+
Classifier: Intended Audience :: Developers
|
|
11
|
+
Classifier: Operating System :: Microsoft :: Windows
|
|
12
|
+
Classifier: Programming Language :: Python :: 3
|
|
13
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
14
|
+
Requires-Python: >=3.9
|
|
15
|
+
Description-Content-Type: text/markdown
|
|
16
|
+
|
|
17
|
+
# VisionGemma MCP
|
|
18
|
+
|
|
19
|
+
mcp-name: io.github.q1023884985/visiongemma
|
|
20
|
+
|
|
21
|
+
**VisionGemma** is a local AI vision recognition MCP server for Windows. It exposes a single `vision_analyze` tool that lets any MCP client (Claude Desktop, Cursor, Cline, opencode, ...) do:
|
|
22
|
+
|
|
23
|
+
- **OCR** — extract text from images and screenshots (Chinese & English)
|
|
24
|
+
- **Chart / diagram analysis** — interpret tables, plots, diagrams and screenshots
|
|
25
|
+
- **Scene description** — describe what is in an image
|
|
26
|
+
- **Object recognition** — identify objects, people, expressions, atmosphere
|
|
27
|
+
|
|
28
|
+
All inference runs **100% locally** via a Vulkan-accelerated on-device engine. Images never leave your machine.
|
|
29
|
+
|
|
30
|
+
> **Note:** this package is the stdio launcher for the MCP Registry. It requires the VisionGemma engine (Windows x64) to be installed. Download it from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases), then run the installer once.
|
|
31
|
+
|
|
32
|
+
## Installation
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
pip install visiongemma-mcp
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Install the VisionGemma engine from the [GitHub Releases](https://github.com/q1023884985/visiongemma/releases) page.
|
|
39
|
+
|
|
40
|
+
## MCP configuration
|
|
41
|
+
|
|
42
|
+
Add to your MCP client config:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"mcpServers": {
|
|
47
|
+
"vision-gemma": {
|
|
48
|
+
"command": "visiongemma",
|
|
49
|
+
"args": ["--mcp"],
|
|
50
|
+
"type": "stdio"
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Or point directly at the engine executable (no pip install needed):
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
{
|
|
60
|
+
"mcpServers": {
|
|
61
|
+
"vision-gemma": {
|
|
62
|
+
"command": "C:\\path\\to\\VisionGemma.exe",
|
|
63
|
+
"args": ["--mcp"],
|
|
64
|
+
"type": "stdio"
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Tool: vision_analyze
|
|
71
|
+
|
|
72
|
+
| Parameter | Type | Description |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| `image_path` | string (required) | Local absolute path, `http(s)://` URL, or base64 data URI of the image |
|
|
75
|
+
| `prompt` | string (optional) | Question or instruction about the image (default: "please describe this image") |
|
|
76
|
+
|
|
77
|
+
## Privacy & licensing
|
|
78
|
+
|
|
79
|
+
- All processing is local and offline — no data leaves your device.
|
|
80
|
+
- Free 7-day trial; 38 CNY one-time purchase to keep it forever. See in-app activation.
|
|
81
|
+
- Windows 10/11 x64, Vulkan-capable GPU (or CPU fallback).
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
README.md
|
|
2
|
+
pyproject.toml
|
|
3
|
+
src/visiongemma_mcp/__init__.py
|
|
4
|
+
src/visiongemma_mcp/__main__.py
|
|
5
|
+
src/visiongemma_mcp/launcher.py
|
|
6
|
+
src/visiongemma_mcp.egg-info/PKG-INFO
|
|
7
|
+
src/visiongemma_mcp.egg-info/SOURCES.txt
|
|
8
|
+
src/visiongemma_mcp.egg-info/dependency_links.txt
|
|
9
|
+
src/visiongemma_mcp.egg-info/entry_points.txt
|
|
10
|
+
src/visiongemma_mcp.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
visiongemma_mcp
|