yourimageshare

yourimageshare-mcp

YourImageShare 用の MCP（Model Context Protocol）サーバーです。 AI コーディングエージェント（Claude Code、Cursor、その他の MCP 対応ツール）向けに作られており、スクリーンショットをバグレポート、PR の説明、サポートスレッドに、base64 の塊や手動アップロードを介さず、実際の URL として貼り付けられます。Claude Desktop やその他の MCP クライアントでも同じように動作します。

• API キーを取得する： サインインして、yourimageshare.com/my-account の API タブを開きます。
• HTTP の完全なリファレンス： yourimageshare.com/about/api。
• OpenAPI 3.1 仕様： yourimageshare.com/openapi.json。README よりこちらを優先するツールをお使いの場合にご利用ください。

インストール／実行

インストールは不要です。npx で直接実行できます。

npx yourimageshare-mcp

MCP クライアントからインストールする場合は、Smithery にも掲載されています。

Claude Desktop／Claude Code の設定

MCP クライアントの設定（例：claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "yourimageshare": {
      "command": "npx",
      "args": ["-y", "yourimageshare-mcp"],
      "env": {
        "YIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

環境変数

変数	必須	用途
YIS_API_KEY	はい	YourImageShare の API キーです。
YIS_BASE_URL	いいえ	API のベース URL を上書きします（デフォルトは https://yourimageshare.com/api）。テスト専用です。

ツール

upload_image

ファイルをアップロードします（最大 200 MB。90 MB を超えるファイルは自動的に分割して送信されます）。次のうち必ず 1 つだけを指定してください。

• path - このサーバープロセスが読み取り可能なローカルファイルパス。
• base64 + filename - インラインのファイル内容。ローカルファイルシステムにアクセスできない MCP クライアント向けです。
• url - YourImageShare サーバー自身がダウンロードする、公開された http(s) リンク。

任意の expiresIn（秒、60～2,592,000＝30 日）を指定すると、後でアップロードが自動削除されます。アカウントがこのファイルをすでにアップロードしている場合は、既存のアップロードが duplicate: true とともに返されます。新しいコピーを保存するには、allowDuplicate を設定してください。id、type、path、src、direct、thumb（幅 280 px の WebP サムネイル）、width、height、size、locked、expires_at、duplicate が返されます。変換後に path が変わることがあるため、src を保存してください。

また、visibility（デフォルトは unlisted。リンクを知っている人なら誰でもファイルとページを利用可能です。private は他の人にはページを表示せず、ファイルのみ利用可能です。public は一覧に表示されます）、title（90 文字）、description（500 文字）も任意で指定できます。新しいアップロードでは、一度だけ使える delete_url が返されます。

get_upload

id が必要です。アップロードのリンク、サムネイル、サイズ、公開範囲、タイトル、説明を返します。

update_upload

id と、visibility、title、description のいずれかが必要です。渡した項目のみが変更されます。空文字列を指定すると、タイトルまたは説明が消去されます。

list_uploads

page は任意です（デフォルトは 1、1 ページあたり 50 件）。アップロードを新しい順に返します。

delete_upload

id（upload_image／list_uploads から取得）が必要です。アップロードを完全に削除します。

注意事項

• このサーバーは常に YIS_API_KEY に紐づくアカウントとしてのみ動作します。接続されたエージェントが別のアカウントとして動作することはできません。
• API のエラー（無効なキー、レート制限、モデレーションによるファイルの拒否など）は、ツール呼び出しがクラッシュするのではなく、API 独自のメッセージを含むツールエラーの結果として返されます。
• 別個の yourimageshare npm パッケージに依存せず、小規模で自己完結型のクライアントとして構築されているため、このサーバーのリリースはそのパッケージのリリースに左右されません。

ライセンス

MIT

Support

yourimageshare.com/contact