mcp-print 0.2.0__tar.gz

mcp_print-0.2.0/.claude/skills/print-workflow/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: print-workflow
+description: Professional print and color workflow assistance. Use when user mentions printing, CMYK, Pantone, ICC profiles, ink consumption, barcodes, or color management.
+---
+
+# Print Workflow Skill
+
+You have access to the mcp-print MCP server with professional printing tools.
+
+## Available tools:
+
+| Tool | Purpose |
+|---|---|
+| `pantone_to_cmyk_tool` | Look up Pantone color → CMYK + HEX (fuzzy matching, 2400+ colors) |
+| `pantone_search_tool` | Find closest Pantone by HEX or CMYK proximity (top N matches) |
+| `cmyk_to_rgb_tool` | Convert CMYK → RGB + HEX |
+| `color_delta_e_tool` | Delta E (CIE76) between two CMYK colors |
+| `ink_consumption_tool` | Estimate ink grams/kg/cost for a print run |
+| `print_cost_estimator_tool` | Full job cost: ink + plates + makeready + run |
+| `icc_profile_info_tool` | Parse ICC/ICM profile metadata from file |
+| `spot_color_separator_tool` | Recommend spot vs process for a color list |
+| `barcode_ink_coverage_tool` | Ink coverage % for Code128/EAN13/QR/DataMatrix |
+| `paper_weight_converter_tool` | Convert GSM ↔ lb text ↔ lb cover |
+
+## When to use each tool:
+- User asks about Pantone colors → `pantone_to_cmyk_tool`, `pantone_search_tool`
+- User asks about color accuracy or matching → `color_delta_e_tool`
+- User asks about ink usage → `ink_consumption_tool`
+- User asks about print job cost → `print_cost_estimator_tool`
+- User mentions ICC profile → `icc_profile_info_tool`
+- User asks about spot vs process colors → `spot_color_separator_tool`
+- User asks about barcodes → `barcode_ink_coverage_tool`
+- User asks about paper weight → `paper_weight_converter_tool`
+
+## Response style:
+- Always show color values as HEX codes in backticks (e.g. `#DA291C`)
+- Round ink weights to 2 decimal places
+- For cost estimates, show a breakdown table
+- Suggest print method when relevant
+- When showing Pantone matches, include the Delta E score for context
+- For spot/process recommendations, explain the reasoning clearly

mcp_print-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]" 2>/dev/null || pip install -e .
+          pip install pytest
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install and run ruff
+        run: |
+          pip install ruff
+          ruff check src/

mcp_print-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.claude/settings.local.json

mcp_print-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mcp-print contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_print-0.2.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: mcp-print
+Version: 0.2.0
+Summary: MCP server for professional print and color workflows — 2400+ Pantone colors, CMYK/RGB conversion, ink/cost estimation, ICC profiles, spot color separation, and more.
+Project-URL: Homepage, https://github.com/mcp-print/mcp-print
+Project-URL: Repository, https://github.com/mcp-print/mcp-print
+Project-URL: Issues, https://github.com/mcp-print/mcp-print/issues
+Author: mcp-print contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cmyk,color,ink,mcp,pantone,prepress,printing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Printing
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# mcp-print
+
+MCP server for professional print and color workflows. Gives AI assistants the ability to work with 2400+ Pantone colors, CMYK/RGB conversion, ink and cost estimation, ICC profile analysis, spot color separation, barcode coverage, Delta E color difference, and paper weight conversion — all offline, no API keys needed.
+
+## Who is this for?
+
+- **Print designers** checking Pantone-to-CMYK conversions without leaving their editor
+- **Prepress engineers** estimating ink costs, verifying color accuracy, and analyzing ICC profiles
+- **Packaging teams** converting paper weights, comparing spot colors, and costing print runs
+
+## Install
+
+```bash
+pip install mcp-print
+```
+
+## Configure with Claude Code
+
+Add to your Claude Code MCP config (`~/.claude/settings.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "print": {
+      "command": "python",
+      "args": ["-m", "mcp_print"]
+    }
+  }
+}
+```
+
+Restart Claude Code — all ten tools below will be available immediately.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `pantone_to_cmyk_tool` | Convert a Pantone name to CMYK + HEX (2400+ colors, fuzzy matching) |
+| `pantone_search_tool` | Find closest Pantone colors by HEX or CMYK proximity |
+| `cmyk_to_rgb_tool` | Convert CMYK values to RGB + HEX |
+| `color_delta_e_tool` | Calculate Delta E (CIE76) between two CMYK colors |
+| `ink_consumption_tool` | Estimate ink usage and cost for a print run |
+| `print_cost_estimator_tool` | Full job cost: ink + plates + makeready + run |
+| `icc_profile_info_tool` | Parse ICC/ICM profile metadata from a file |
+| `spot_color_separator_tool` | Recommend spot vs process colors for a design |
+| `barcode_ink_coverage_tool` | Ink coverage % for Code128, EAN-13, QR, DataMatrix |
+| `paper_weight_converter_tool` | Convert between GSM, lb text, and lb cover |
+
+## Usage Examples
+
+Once configured, just ask Claude naturally:
+
+### 1. Pantone lookup (with fuzzy matching)
+
+> "What's the CMYK breakdown for Pantone 485 C?"
+
+Works with any format: `"485C"`, `"pantone 485"`, `"485 coated"`, `"Warm Red"`.
+
+```json
+{ "name": "Pantone 485 C", "c": 0, "m": 95, "y": 100, "k": 0, "hex": "#FF0D0D" }
+```
+
+### 2. Find closest Pantone to a HEX color
+
+> "What Pantone colors are closest to #DA291C?"
+
+```json
+{
+  "matches": [
+    { "name": "Pantone 485 C", "c": 0, "m": 95, "y": 100, "k": 0, "hex": "#FF0D0D" },
+    { "name": "Pantone 485 M", "c": 1, "m": 93, "y": 99, "k": 2, "hex": "#FA0E03" }
+  ],
+  "search_type": "hex #DA291C"
+}
+```
+
+### 3. Color conversion
+
+> "Convert CMYK 100/44/0/0 to RGB"
+
+```json
+{ "r": 0, "g": 143, "b": 255, "hex": "#008FFF" }
+```
+
+### 4. Ink estimation
+
+> "How much ink do I need for 10,000 A4 flyers at 35% coverage on an offset press?"
+
+```json
+{ "ink_grams": 327.44, "ink_kg": 0.3274, "cost_estimate_usd": 8.19 }
+```
+
+### 5. Full print job costing
+
+> "Cost estimate: 5000 copies of an A4 flyer, 4-color offset, 120gsm, double-sided"
+
+```json
+{
+  "total_cost_usd": 628.14,
+  "cost_per_unit_usd": 0.1256,
+  "breakdown": { "ink": 11.34, "plates": 280.0, "makeready": 200.0, "run_cost": 136.8 }
+}
+```
+
+### 6. Color matching QC
+
+> "Compare our brand blue (100/72/0/18) against the proof (98/70/2/20) — is the Delta E acceptable?"
+
+```json
+{ "delta_e": 3.41, "interpretation": "fair — noticeable difference" }
+```
+
+### 7. Spot vs process recommendation
+
+> "Should these colors be spot or process?" (with a list of CMYK values)
+
+```json
+{
+  "spot_colors": [{ "nearest_pantone": "Pantone 485 C", "delta_e": 0.0, "reason": "Close match..." }],
+  "process_colors": [{ "nearest_pantone": "Pantone 375 C", "delta_e": 8.2, "reason": "No close match..." }]
+}
+```
+
+### 8. ICC profile inspection
+
+> "What color space is this ICC profile using?"
+
+```json
+{
+  "profile_name": "ISOcoated_v2",
+  "color_space": "CMYK",
+  "device_class": "Output (Printer)",
+  "version": "2.4.0"
+}
+```
+
+### 9. Barcode ink coverage
+
+> "What's the ink coverage for an EAN-13 barcode at 37mm x 26mm?"
+
+```json
+{
+  "coverage_percent": 52.0,
+  "recommended_ink": "Process Black (K: 100)",
+  "print_method_suggestion": "offset — good resolution for medium modules"
+}
+```
+
+### 10. Paper weight conversion
+
+> "What's 80 lb text in GSM?"
+
+```json
+{ "value": 118.42, "from_unit": "lb_text", "to_unit": "gsm" }
+```
+
+## Pantone Database
+
+The built-in database contains **2400+ Pantone colors** covering:
+
+- **Numeric series** (100-699): Yellows, oranges, reds, pinks, purples, blues, greens, grays, browns
+- **7000 series** (7400-7547): Extended gamut colors
+- **Special named colors**: Black, White, Warm Red, Reflex Blue, Process Blue, Cool/Warm Grays 1-11, Hexachrome series, and more
+- **Three finishes per color**: Coated (C), Uncoated (U), and Matte (M)
+
+Fuzzy matching handles typos and format variations — `"485C"`, `"pantone 485"`, `"485 coated"` all find the right color.
+
+## Development
+
+```bash
+git clone https://github.com/mcp-print/mcp-print.git
+cd mcp-print
+pip install -e .
+pip install pytest
+pytest tests/ -v
+```
+
+## License
+
+MIT

mcp_print-0.2.0/README.md

@@ -0,0 +1,180 @@
+# mcp-print
+
+MCP server for professional print and color workflows. Gives AI assistants the ability to work with 2400+ Pantone colors, CMYK/RGB conversion, ink and cost estimation, ICC profile analysis, spot color separation, barcode coverage, Delta E color difference, and paper weight conversion — all offline, no API keys needed.
+
+## Who is this for?
+
+- **Print designers** checking Pantone-to-CMYK conversions without leaving their editor
+- **Prepress engineers** estimating ink costs, verifying color accuracy, and analyzing ICC profiles
+- **Packaging teams** converting paper weights, comparing spot colors, and costing print runs
+
+## Install
+
+```bash
+pip install mcp-print
+```
+
+## Configure with Claude Code
+
+Add to your Claude Code MCP config (`~/.claude/settings.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "print": {
+      "command": "python",
+      "args": ["-m", "mcp_print"]
+    }
+  }
+}
+```
+
+Restart Claude Code — all ten tools below will be available immediately.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `pantone_to_cmyk_tool` | Convert a Pantone name to CMYK + HEX (2400+ colors, fuzzy matching) |
+| `pantone_search_tool` | Find closest Pantone colors by HEX or CMYK proximity |
+| `cmyk_to_rgb_tool` | Convert CMYK values to RGB + HEX |
+| `color_delta_e_tool` | Calculate Delta E (CIE76) between two CMYK colors |
+| `ink_consumption_tool` | Estimate ink usage and cost for a print run |
+| `print_cost_estimator_tool` | Full job cost: ink + plates + makeready + run |
+| `icc_profile_info_tool` | Parse ICC/ICM profile metadata from a file |
+| `spot_color_separator_tool` | Recommend spot vs process colors for a design |
+| `barcode_ink_coverage_tool` | Ink coverage % for Code128, EAN-13, QR, DataMatrix |
+| `paper_weight_converter_tool` | Convert between GSM, lb text, and lb cover |
+
+## Usage Examples
+
+Once configured, just ask Claude naturally:
+
+### 1. Pantone lookup (with fuzzy matching)
+
+> "What's the CMYK breakdown for Pantone 485 C?"
+
+Works with any format: `"485C"`, `"pantone 485"`, `"485 coated"`, `"Warm Red"`.
+
+```json
+{ "name": "Pantone 485 C", "c": 0, "m": 95, "y": 100, "k": 0, "hex": "#FF0D0D" }
+```
+
+### 2. Find closest Pantone to a HEX color
+
+> "What Pantone colors are closest to #DA291C?"
+
+```json
+{
+  "matches": [
+    { "name": "Pantone 485 C", "c": 0, "m": 95, "y": 100, "k": 0, "hex": "#FF0D0D" },
+    { "name": "Pantone 485 M", "c": 1, "m": 93, "y": 99, "k": 2, "hex": "#FA0E03" }
+  ],
+  "search_type": "hex #DA291C"
+}
+```
+
+### 3. Color conversion
+
+> "Convert CMYK 100/44/0/0 to RGB"
+
+```json
+{ "r": 0, "g": 143, "b": 255, "hex": "#008FFF" }
+```
+
+### 4. Ink estimation
+
+> "How much ink do I need for 10,000 A4 flyers at 35% coverage on an offset press?"
+
+```json
+{ "ink_grams": 327.44, "ink_kg": 0.3274, "cost_estimate_usd": 8.19 }
+```
+
+### 5. Full print job costing
+
+> "Cost estimate: 5000 copies of an A4 flyer, 4-color offset, 120gsm, double-sided"
+
+```json
+{
+  "total_cost_usd": 628.14,
+  "cost_per_unit_usd": 0.1256,
+  "breakdown": { "ink": 11.34, "plates": 280.0, "makeready": 200.0, "run_cost": 136.8 }
+}
+```
+
+### 6. Color matching QC
+
+> "Compare our brand blue (100/72/0/18) against the proof (98/70/2/20) — is the Delta E acceptable?"
+
+```json
+{ "delta_e": 3.41, "interpretation": "fair — noticeable difference" }
+```
+
+### 7. Spot vs process recommendation
+
+> "Should these colors be spot or process?" (with a list of CMYK values)
+
+```json
+{
+  "spot_colors": [{ "nearest_pantone": "Pantone 485 C", "delta_e": 0.0, "reason": "Close match..." }],
+  "process_colors": [{ "nearest_pantone": "Pantone 375 C", "delta_e": 8.2, "reason": "No close match..." }]
+}
+```
+
+### 8. ICC profile inspection
+
+> "What color space is this ICC profile using?"
+
+```json
+{
+  "profile_name": "ISOcoated_v2",
+  "color_space": "CMYK",
+  "device_class": "Output (Printer)",
+  "version": "2.4.0"
+}
+```
+
+### 9. Barcode ink coverage
+
+> "What's the ink coverage for an EAN-13 barcode at 37mm x 26mm?"
+
+```json
+{
+  "coverage_percent": 52.0,
+  "recommended_ink": "Process Black (K: 100)",
+  "print_method_suggestion": "offset — good resolution for medium modules"
+}
+```
+
+### 10. Paper weight conversion
+
+> "What's 80 lb text in GSM?"
+
+```json
+{ "value": 118.42, "from_unit": "lb_text", "to_unit": "gsm" }
+```
+
+## Pantone Database
+
+The built-in database contains **2400+ Pantone colors** covering:
+
+- **Numeric series** (100-699): Yellows, oranges, reds, pinks, purples, blues, greens, grays, browns
+- **7000 series** (7400-7547): Extended gamut colors
+- **Special named colors**: Black, White, Warm Red, Reflex Blue, Process Blue, Cool/Warm Grays 1-11, Hexachrome series, and more
+- **Three finishes per color**: Coated (C), Uncoated (U), and Matte (M)
+
+Fuzzy matching handles typos and format variations — `"485C"`, `"pantone 485"`, `"485 coated"` all find the right color.
+
+## Development
+
+```bash
+git clone https://github.com/mcp-print/mcp-print.git
+cd mcp-print
+pip install -e .
+pip install pytest
+pytest tests/ -v
+```
+
+## License
+
+MIT

mcp_print-0.2.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-print"
+version = "0.2.0"
+description = "MCP server for professional print and color workflows — 2400+ Pantone colors, CMYK/RGB conversion, ink/cost estimation, ICC profiles, spot color separation, and more."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "mcp-print contributors" },
+]
+keywords = ["mcp", "printing", "cmyk", "pantone", "prepress", "color", "ink"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Printing",
+]
+dependencies = [
+    "mcp>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/mcp-print/mcp-print"
+Repository = "https://github.com/mcp-print/mcp-print"
+Issues = "https://github.com/mcp-print/mcp-print/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_print"]