Metadata-Version: 2.4
Name: morphiaone-mcp
Version: 0.1.0
Summary: MCP server for MorphiaOne shade digitisation, a thin client of the public V1 API.
Author: MorphiaOne
License-Expression: MIT
Project-URL: Documentation, https://docs.morphiaone.ai/guides/ai-agents
Project-URL: Repository, https://github.com/MorphiaOne/vision-api
Keywords: morphiaone,mcp,model-context-protocol,ai-agents,digitisation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: <3.15,>=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: morphiaone<0.12,>=0.11
Requires-Dist: mcp<2.4,>=2.3.0
Dynamic: license-file

# morphiaone-mcp

An [MCP](https://modelcontextprotocol.io) server that lets Claude, Cursor or any MCP
client digitise product shade colours through the MorphiaOne V1 API: retain a photo,
measure regions, propose a candidate, review it and stage it as an unpublished
catalogue draft. It is a thin client of the public API, so your key's scopes, rate
limits, credits and test mode apply as they do anywhere else.

## Install

```sh
pip install morphiaone        # the CLI that writes the client configuration
morphiaone mcp install --client claude-code     # or cursor, claude-desktop
```

`morphiaone mcp install` adds one `morphiaone` server to the client's configuration
and leaves the others as they are. It runs `morphiaone-mcp` if it is on your `PATH`
(`pipx install morphiaone-mcp`), otherwise `uvx morphiaone-mcp`. `--print` shows the
entry without writing it.

The server reads the key from `MORPHIAONE_API_KEY`. Claude Code and Cursor expand that
reference when they start the server, so no key is written to their files. Claude
Desktop expands nothing, so its file would hold the key: the command writes it only
with `--store-key`. Use a test-mode key, or one with only `digitisation.read` and
`digitisation.write`, and revoke it when you stop.

`MORPHIAONE_BASE_URL` defaults to `https://api.morphiaone.ai`.

## What the agent can do

The tools it sees are the ones your key holds every scope for. Give an agent
`digitisation.read` and `digitisation.write` and it proposes; a person reviews and
stages in the Platform. Staging is not publishing: a draft renders nothing until
someone publishes it.

Guide, tools and scopes: https://docs.morphiaone.ai/guides/ai-agents

`morphiaone-mcp --version` prints the installed version; include it when you report a
problem, with the `request_id` of any refused call.
