# mcp-server

This read-only MCP server gives agents a print vocabulary plus configuration checks. It fits workflows that need structured product and colour data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ptpge
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ptpge/ptpge-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ptpge-mcp-server

## What it does

mcp-server exposes the PTPGE print vocabulary to an AI agent. Its tools search and inspect terms, browse the hierarchy, read product-envelope requirements, and validate configurations against allowed values, cardinality, numeric ranges, and cross-variable rules.

The server also converts notation such as `4/4` into ink counts, resolves a validated configuration into a `ptpge-cfs/1` fingerprint, and expands a fingerprint back into configuration data. It caches the dataset in memory and refreshes it when the dataset version changes. The public endpoint needs no key, so a basic connection does not require auth setup.

Use Streamable HTTP at `https://mcp.ptpge.org/mcp`, or run the service locally with Python and `requirements.txt`. The local setup exposes `POST /mcp`; its endpoint can be checked with `http://localhost:8000/mcp`. Runtime options cover dataset refresh, logging, and optional access controls.

## Requirements
- Remote server: `https://mcp.ptpge.org/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.ptpge.org/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ptpge-mcp-server --url https://mcp.ptpge.org/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ptpge-mcp-server": {
            "url": "https://mcp.ptpge.org/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ptpge-mcp-server": {
            "type": "http",
            "url": "https://mcp.ptpge.org/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ptpge-mcp-server https://mcp.ptpge.org/mcp
```

## When to use it
- search a print term in the vocabulary
- validate a product configuration
- turn `4/4` into ink counts
- generate a configuration fingerprint

## Example prompts
- Look up `roll fold` and explain its related terms.
- Validate this brochure configuration against the applicable product envelope.
- Create a `ptpge-cfs/1` fingerprint from the validated print configuration.

## Similar
- [k2f-idml](https://affpapa.org/en/nevibecode/skills/k2f-idml.md) — skill · 2500 installs
- [GIMP Studio MCP](https://affpapa.org/en/nevibecode/mcp/gimp-studio-mcp.md) — MCP server
- [business-card-generation](https://affpapa.org/en/nevibecode/skills/business-card-generation.md) — skill · 318 installs
- [colorize](https://affpapa.org/en/nevibecode/skills/colorize.md) — skill · 890 installs
- [graphic-design](https://affpapa.org/en/nevibecode/skills/graphic-design.md) — skill · 492 installs
- [Tailwind Shades](https://affpapa.org/en/nevibecode/mcp/tailwind-shades.md) — MCP server · ★ 78

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43929
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md