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.
@@ -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,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,4 @@
1
+ from .launcher import main
2
+
3
+ __all__ = ["main"]
4
+ __version__ = "2.1.0"
@@ -0,0 +1,6 @@
1
+ import sys
2
+
3
+ from .launcher import main
4
+
5
+ if __name__ == "__main__":
6
+ sys.exit(main())
@@ -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,2 @@
1
+ [console_scripts]
2
+ visiongemma = visiongemma_mcp:main
@@ -0,0 +1 @@
1
+ visiongemma_mcp