Photo Mcp

photo-mcp

A Claude Code plugin that provides Unsplash photo search tools via MCP.

Note: This uses Unsplash's internal API. No API key required, but endpoints may change without notice.

Tools

Tool	Description
search_photos	Search Unsplash by query
get_photo	Get full details for a photo ID
get_related_photos	Find visually similar photos
get_photo_series	Get photos from the same series as a given photo
get_collection_photos	Get all photos from a collection by ID

Installation

Claude Code Plugin (recommended)

/plugin marketplace add jsemldonado/photo-mcp
/plugin install photo-mcp@photo-mcp-marketplace

Then restart Claude Code.

As MCP Server

Add to your .mcp.json or MCP client config:

{
  "mcpServers": {
    "photo-mcp": {
      "command": "npx",
      "args": ["photo-mcp"]
    }
  }
}

Local development

claude --plugin-dir /path/to/photo-mcp

Project Structure

photo-mcp/
├── .claude-plugin/
│   └── plugin.json       # Claude Code plugin manifest
├── .mcp.json             # MCP server configuration
└── mcp/
    ├── src/
    │   ├── lib/
    │   │   └── unsplash.ts
    │   └── tools/
    │       ├── search-photos.ts
    │       ├── get-photo.ts
    │       ├── get-related-photos.ts
    │       └── get-photo-series.ts
    ├── dist/             # Built output
    ├── xmcp.config.ts
    └── package.json

Development

cd mcp
bun install
bun run dev

Build

cd mcp
bun run build

License

MIT