English Français العربية

com.phototology/mcp

Registre officiel Médias et design

Persistent memory for visual intelligence. A photo registry: analyze once, look up free after that.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @phototology/mcp
Claude Code 
claude mcp add com-phototology-mcp -e 'PHOTOTOLOGY_API_KEY=<your phototology_api_key>' -e 'PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL>' -e 'PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY>' -e 'DO_NOT_TRACK=<DO_NOT_TRACK>' -e 'PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS>' -- npx -y @phototology/mcp@2.0.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "com-phototology-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@phototology/mcp@2.0.0"
            ],
            "env": {
                "PHOTOTOLOGY_API_KEY": "<your phototology_api_key>",
                "PHOTOTOLOGY_BASE_URL": "<PHOTOTOLOGY_BASE_URL>",
                "PHOTOTOLOGY_MCP_NO_TELEMETRY": "<PHOTOTOLOGY_MCP_NO_TELEMETRY>",
                "DO_NOT_TRACK": "<DO_NOT_TRACK>",
                "PHOTOTOLOGY_MCP_ALLOWED_DIRS": "<PHOTOTOLOGY_MCP_ALLOWED_DIRS>"
            }
        }
    }
}

Variables d'environnement

  • PHOTOTOLOGY_API_KEY obligatoire secret Your Phototology API key (pt_live_... for production, pt_test_... for the free fixture sandbox). Get one at https://phototology.com/dashboard. New accounts include 1,000 free credits on email verification.
  • PHOTOTOLOGY_BASE_URL Override the API base URL. Defaults to https://api.phototology.com. Used for local development against phototology-api.
  • PHOTOTOLOGY_MCP_NO_TELEMETRY Set to 1 to disable anonymous telemetry: the editor name and version, the package version, and per tool call the tool name, success, duration, error code and counts. Never image content, file paths, tool inputs or outputs, or conversation text.
  • DO_NOT_TRACK Set to 1 to disable telemetry. Same effect as PHOTOTOLOGY_MCP_NO_TELEMETRY; follows the cross-tool convention many CLIs honor.
  • PHOTOTOLOGY_MCP_ALLOWED_DIRS Folders the server may read photos from and write enriched copies to, separated by : (; on Windows). Unset means any local path. Paths are checked after symlinks are resolved.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Phototology
  2. Packages
  3. Quick start
  4. How it's built
  5. License

Phototology

Persistent memory for visual intelligence.

phototology.com · npm scope: @phototology

Phototology is a visual-intelligence platform that analyzes a photo once and remembers the result forever, keyed by perceptual hash. Re-running any analysis on the same image — by any client, on any future day — returns the cached structured result for free.

This repository is the public source for the three npm packages that surround the platform. The Phototology API itself runs as a hosted service at api.phototology.com.

Packages

PackagePurposenpm
@phototology/sdkTypeScript client SDKnpmjs.com/package/@phototology/sdk
@phototology/mcpModel Context Protocol server for Claude Code, Cursor, VS Code, and other AI coding assistantsnpmjs.com/package/@phototology/mcp
phototologyUnscoped flagship placeholder; reserves the bare name and points to the working packagesnpmjs.com/package/phototology

Each package has its own README and CHANGELOG in its directory.

Quick start

Use the MCP in Claude Code, Cursor, or VS Code (no API key needed for the test sandbox):

npx -y @phototology/mcp

For a real API key, sign up at phototology.com.

Use the SDK programmatically:

npm install @phototology/sdk
import { PhototologyClient } from '@phototology/sdk';

const client = new PhototologyClient({ apiKey: process.env.PHOTOTOLOGY_API_KEY });
const result = await client.analyze({
  imageUrl: 'https://example.com/photo.jpg',
  lenses: ['dating', 'people', 'location'],
});
console.log(result);

How it's built

This repo is a public mirror of the relevant subdirectories from a private monorepo. Source changes flow one-way: monorepo → here. Issues and pull requests on the public packages are welcomed; the maintainer will sync fixes back to the monorepo.

The monorepo uses pnpm workspaces, TypeScript, jest (MCP) / vitest (SDK has light coverage), and ships through a sync script (scripts/sync-phototology-public.sh in the private repo).

License

MIT — see LICENSE. Each package also carries its own copy of the MIT license in its directory.

Questions fréquentes

Qu'est-ce que com.phototology/mcp ?

Persistent memory for visual intelligence. A photo registry: analyze once, look up free after that.

Comment installer com.phototology/mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add com-phototology-mcp -e 'PHOTOTOLOGY_API_KEY=<your phototology_api_key>' -e 'PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL>' -e 'PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY>' -e 'DO_NOT_TRACK=<DO_NOT_TRACK>' -e 'PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS>' -- npx -y @phototology/mcp@2.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.phototology/mcp ?

Oui. Il attend PHOTOTOLOGY_API_KEY, à renseigner dans sa configuration.

com.phototology/mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.phototology/mcp ?

Il est publié par phototology-ai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.