Immich MCP

ImmichMCP

一种模型上下文协议（MCP）服务器 伊米奇 -自托管照片和视频管理解决方案。该服务器提供一流的AI界面来管理您的Immich库。

特性

• 资产管理：搜索、浏览、上传、更新和删除照片/视频
• 智能搜索：使用CLIP的基于ML的语义搜索（例如，“海滩上的日落”）
• 元数据搜索：按日期、位置、相机、人物等筛选
• 专辑：创建、管理和共享相册
• 人们：查看和管理人脸识别集群
• 标签：使用自定义标签组织资产
• 共享链接：为相册和资源创建可共享的URL
• 活动：向相册/资产添加评论和点赞

需求

• .NET 10.0 SDK
• Immich服务器实例
• Immich API密钥

安装

选项1：从源代码运行

# Clone the repository
git clone https://github.com/barryw/ImmichMCP.git
cd ImmichMCP

# Set environment variables
export IMMICH_BASE_URL="https://photos.example.com"
export IMMICH_API_KEY="your-api-key"

# Run with stdio transport (for Claude Desktop)
dotnet run --project ImmichMCP -- --stdio

# Or run with HTTP transport (for remote usage)
dotnet run --project ImmichMCP

选项2:Docker

docker run -e IMMICH_BASE_URL="https://photos.example.com" \
           -e IMMICH_API_KEY="your-api-key" \
           -p 5000:5000 \
           ghcr.io/barryw/immichmcp:latest

环境变量

Claude桌面配置

添加到您的Claude桌面配置(~/.config/claude/claude_desktop_config.json 在Linux/macOS或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "immich": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/ImmichMCP/ImmichMCP", "--", "--stdio"],
      "env": {
        "IMMICH_BASE_URL": "https://photos.example.com",
        "IMMICH_API_KEY": "your-api-key"
      }
    }
  }
}

或者使用Docker：

{
  "mcpServers": {
    "immich": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-e", "IMMICH_BASE_URL=https://photos.example.com",
               "-e", "IMMICH_API_KEY=your-api-key",
               "ghcr.io/barryw/immichmcp:latest", "--stdio"]
    }
  }
}

可用工具

健康与能力

资产

搜索

专辑

人们

标签

共享链接

活动

示例用法

搜索上个月的照片

Search for photos taken in the last 30 days that are favorites

创建相册并添加照片

Create a new album called "2026 Winter Vacation" and add all photos from January 2026

智能搜索

Find photos of sunset at the beach

批量存档

Archive all photos from 2020 that aren't favorites

安全特性

• 所有破坏性操作都需要明确 confirm: true 参数
• 批量操作默认为 dryRun: true 模式
• 在不进行更改的情况下，模拟运行会返回受影响的内容

响应格式

所有工具都返回一致的JSON信封：

{
  "ok": true,
  "result": { ... },
  "meta": {
    "request_id": "uuid",
    "page": 1,
    "page_size": 25,
    "total": 123,
    "next": "cursor-or-null",
    "immich_base_url": "https://photos.example.com"
  },
  "warnings": []
}

错误响应：

{
  "ok": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Asset not found",
    "details": { ... }
  },
  "meta": { ... }
}

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

相关项目

• 伊米奇 -自托管照片和视频管理
• 无纸化MCP -无纸化ngx的MCP服务器