mufmuf-mcp

Mufmuf MCP server

An MCP server that scores how visually compatible two photos are, using the Mufmuf public API. Exposes one tool, compare_compatibility, over stdio so it works in Claude Desktop, Cursor, VS Code, and any other MCP client.

AI-generated and directional only, not a factual judgment.

Prerequisites

• A Mufmuf account.
• An API key minted at https://mufmuf.app/settings/api-keys (you'll see the key once — copy it). The key carries a per-key daily request limit.

Install & run

npm install -g mufmuf-mcp        # once published
MUFMUF_API_KEY=mk_live_… mufmuf-mcp

Or run from source:

cd mcp
npm install
npm run build
MUFMUF_API_KEY=mk_live_… node dist/index.js

Configuration

Env var	Required	Default	Purpose
MUFMUF_API_KEY	yes	—	Your mk_live_… API key.
MUFMUF_API_BASE	no	https://mufmuf.app	Override for self-host/staging.

Wire it into a client

Claude Desktop / Cursor / VS Code (mcp.json)

{
  "mcpServers": {
    "mufmuf": {
      "command": "mufmuf-mcp",
      "env": { "MUFMUF_API_KEY": "mk_live_…" }
    }
  }
}

The tool

compare_compatibility

Argument	Type	Notes
userImage	string	data URI, bare base64, http(s) URL, or local file path
targetImage	string	same as above

Returns JSON: { score, subScores, summary, disclaimer }.

Publishing to MCP registries (owner action)

The package and its registry manifests are publish-ready: package.json carries the metadata + a prepublishOnly build hook, server.json is filled in for the official MCP registry, and smithery.yaml is filled in for Smithery. The only remaining steps need your npm / registry credentials and are irreversible, so they stay manual:

• npm (so npx mufmuf-mcp works):

  cd mcp
  npm login                      # your npm account
  npm publish --access public    # prepublishOnly runs the build for you
  

• Official MCP registry (modelcontextprotocol/registry): publish the prepared server.json with the registry CLI:

  # https://github.com/modelcontextprotocol/registry
  mcp-publisher login github      # authenticate the io.github.iziklisbon namespace
  mcp-publisher publish           # reads ./server.json
  

  Confirm the $schema URL + namespace still match the registry's current docs before publishing; adjust server.json if the schema has moved.
• Smithery (https://smithery.ai): connect this GitHub repo; Smithery reads the prepared smithery.yaml (stdio command + the MUFMUF_API_KEY / MUFMUF_API_BASE config).
• Awesome MCP lists / PulseMCP: open a PR / submit the listing once the npm package is live.

Bump version in package.json and server.json before each publish.

The public API the server calls is documented as OpenAPI at https://mufmuf.app/openapi.yaml (and summarized for agents at https://mufmuf.app/llms.txt).

Develop & test

cd mcp
npm install
npm test          # node:test unit tests for the API client