English Français العربية

com.phototology/mcp

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • PHOTOTOLOGY_API_KEY إلزامي سري 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو com.phototology/mcp؟

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

كيف أثبّت com.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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.phototology/mcp إلى مفتاح API؟

نعم. يتطلب PHOTOTOLOGY_API_KEY، وتضبطها في إعداداته.

هل com.phototology/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.phototology/mcp؟

ينشره phototology-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.