Lorem Picsum

Lorem Picsum · MCP + OAuth 2.1將 AI 助理連線至 Picsum

透過 MCP 和 OAuth,即可在 Claude Code、Codex 或 Grok Bot 裡搜尋 CC0 照片並建立圖片網址。

https://picsum.org/mcp
  • Claude Code
  • Codex
  • Grok Bot

選擇要連線的助理

Claude Code

  1. 1
    新增伺服器。
    終端機
    claude mcp add --transport http picsum https://picsum.org/mcp
  2. 2
    在 Claude Code 執行 /mcp,選擇 picsum,再選 Authenticate。接著在瀏覽器同意授權。
  3. 3
    請到 Picsum 找三張咖啡照片,並提供 800 × 600 的 img 標籤。

Codex

  1. 1
    新增伺服器。
    終端機
    codex mcp add picsum --url https://picsum.org/mcp
  2. 2
    使用 OAuth 登入。
    終端機
    codex mcp login picsum
    登入遠端 MCP 伺服器需要較新版的 Codex CLI。你也可以把以下設定加到 ~/.codex/config.toml 的 [mcp_servers.picsum] 區段。url = "https://picsum.org/mcp"
  3. 3
    請用 Picsum 隨機挑選的美食照片填滿這個格狀版面。

Grok Bot

  1. 1
    在機器人的工具設定中,依下列資訊新增遠端 MCP 伺服器。
    設定
    Name: picsum
    URL: https://picsum.org/mcp
    Transport: Streamable HTTP
    Auth: OAuth
  2. 2
    看到登入提示時請登入。機器人會自動找到 OAuth 端點並完成用戶端註冊。
  3. 3
    不同版本的選單名稱可能不同。支援 OAuth 與用戶端動態註冊的其他 MCP 用戶端也能連線。

觀看 60 秒操作示範(英文)

助理可以做什麼

search_photos

用標籤與分類搜尋 CC0 照片。搜尋結果會分頁,每筆都附有可直接使用的圖片網址。

get_photo

用照片 ID 查詢作者、說明、標籤、尺寸、來源和授權。

list_categories

列出分類的 ID 和名稱,分組方式與首頁相同。

build_image_url

建立指定尺寸的圖片網址與 HTML img 標籤,支援種子值、分類、灰階、模糊和 WebP。

唯讀存取

  • 助理可以搜尋公開的 CC0 圖庫並建立圖片連結,無法查看或變更你的帳號與檔案。
  • 工具可以讀取照片和建立圖片連結,無法變更你的帳戶。
  • 每次連線前,授權畫面都會顯示提出存取要求的應用程式。
  • 你隨時可以從助理設定移除伺服器來中斷連線。權杖在一小時後到期,最長可續期 30 天。
  • OAuth 2.1 必須使用 PKCE。用戶端可動態註冊,無須複製用戶端密碼。

端點

MCP 伺服器
https://picsum.org/mcp
資源中繼資料
https://picsum.org/.well-known/oauth-protected-resource
授權伺服器
https://picsum.org/.well-known/oauth-authorization-server
授權畫面
https://picsum.org/connect/authorize
權杖端點
https://picsum.org/api/auth/mcp/token
用戶端註冊
https://picsum.org/api/auth/mcp/register