Bring Media Management
to VS Code Copilot
Learn how to connect PhotoPrism to VS Code Copilot and start using 7 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the PhotoPrism MCP Server?
Connect your self-hosted PhotoPrism instance to any AI agent to interact with your personal media collection through natural language.
What you can do
- Advanced Search — Query your library using keywords, colors, or dates with the
search_photostool. - Visual Previews — Generate direct URLs for thumbnails in various sizes using
get_thumbnail_url. - Video Streaming — Access streaming links for your stored videos with
get_video_url. - OAuth Management — Handle authentication tokens and user information securely with
create_oauth_tokenandget_oauth_userinfo.
How it works
- Subscribe to this server
- Enter your PhotoPrism URL and API Token
- Start searching and viewing your media from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Photography Enthusiasts — Quickly find specific shots without manual scrolling through thousands of files
- Self-Hosters — Integrate your private cloud with your favorite AI tools for a seamless media experience
- Content Creators — Retrieve assets from your library directly within your coding or writing workflow
Built-in capabilities (7)
Create an OAuth2 token
Get OAuth2 Authorization
Get OAuth2 UserInfo
Get a thumbnail image URL for a photo
Get a video streaming URL
Revoke an OAuth2 token
Search for photos in PhotoPrism
Why VS Code Copilot?
GitHub Copilot Agent mode brings PhotoPrism data directly into your VS Code workflow. With a project-scoped config, the entire team shares access to 7 tools. Copilot queries live data, generates typed code, and writes tests from actual API responses, all without leaving the editor.
- —
VS Code is used by over 70% of developers. adding MCP tools to Copilot means your team can leverage external data without leaving their primary editor
- —
Project-scoped MCP configs (
.vscode/mcp.json) let you commit server configurations to your repository, ensuring the entire team shares the same tool access - —
Copilot's Agent mode integrates MCP tools seamlessly with file editing, terminal commands, and workspace search in a single agentic loop
- —
GitHub's enterprise compliance and audit features extend to MCP tool usage, providing visibility into how AI interacts with external services
PhotoPrism in VS Code Copilot
PhotoPrism and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect PhotoPrism to VS Code Copilot through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for PhotoPrism in VS Code Copilot
The PhotoPrism MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 7 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in VS Code Copilot only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
PhotoPrism for VS Code Copilot
Every tool call from VS Code Copilot to the PhotoPrism MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
Can I search for photos by specific filters like color or camera model?
Yes! Use the search_photos tool with the q parameter. You can use filters like 'color:blue' or 'camera:iPhone' just as you would in the PhotoPrism web interface.
What thumbnail sizes are available for my photos?
The get_thumbnail_url tool supports several standard sizes: tile_50, tile_500, fit_720, fit_1280, and fit_1920.
Does this integration support video playback?
Yes. The get_video_url tool constructs a streaming URL for a specific file hash, allowing you to view your videos directly from the provided link.
Which VS Code version supports MCP?
MCP support requires VS Code 1.99 or later with the GitHub Copilot extension. Ensure both are updated to the latest version. Older versions of Copilot may not expose the Agent mode toggle.
How do I switch to Agent mode?
Open the Copilot Chat panel and look for two mode options: "Ask" and "Agent". Click "Agent" to enable autonomous tool calling. In Ask mode, Copilot provides conversational answers but cannot invoke MCP tools.
Can I restrict which MCP tools Copilot can access?
Yes. VS Code shows a tool consent dialog before any MCP tool is invoked for the first time. You can also configure tool access policies at the organization level through GitHub Copilot settings.
Does MCP work in VS Code Remote or Codespaces?
Yes. MCP servers configured via .vscode/mcp.json work in Remote SSH, WSL, and GitHub Codespaces environments. The MCP connection is established from the remote host, so ensure the server URL is accessible from that environment.
MCP tools not available
Ensure you are in Agent mode in Copilot Chat. MCP tools only appear in Agent mode.
Explore More MCP Servers
View all →
Typefully
9 toolsWrite, schedule, and grow your audience on Twitter and LinkedIn with an editor that helps you craft threads that go viral.
NASA Exoplanets — Worlds Beyond Our Solar System
4 toolsExplore 5,700+ confirmed exoplanets from NASA's Exoplanet Archive: search by discovery method, find habitable zone candidates, browse transit planets from Kepler and TESS missions, and analyze global discovery statistics spanning three decades of planet hunting.
Abyssale
4 toolsAutomated creative production — generate dynamic images, banners, and personalized visuals via AI.
Planet Labs
12 toolsAccess daily satellite imagery via Planet Labs — search PSScene, SkySat, and RapidEye imagery, filter by cloud cover, and set up automated imagery delivery from any AI agent.