gyazo-mcp-server-0.2.0 is not a library.

gyazo-mcp-server

Gyazo 向けのローカル MCP サーバーです。/mcp の streamable HTTP transport と、MCP 標準 login に準拠した認証 broker、さらに stdio transport を備えています。

Features

streamable HTTP transport と stdio transport の両対応
MCP 標準 login に対応した OAuth broker
Gyazo の list / get / latest / search / upload / delete / oEmbed tools
gyazo-mcp:///image_id 形式の resources

Available Tools

gyazo_whoami
gyazo_search
gyazo_list_images
gyazo_get_image
gyazo_delete_image
gyazo_get_latest_image
gyazo_upload_image
gyazo_get_oembed_metadata

Install

crates.io からインストールする場合は、次のコマンドを使用します。

cargo install gyazo-mcp-server

インストール後のバイナリは通常 ~/.cargo/bin/gyazo-mcp-server に配置されます。

ローカルソースからインストールする場合は、次のコマンドを使用します。

cargo install --path .

アンインストールは次のとおりです。

cargo uninstall gyazo-mcp-server

Build

開発ビルド:

cargo build

リリースビルド:

cargo build --release

生成されるバイナリは次のとおりです。

target/release/gyazo-mcp-server

Config

動作設定は ~/.config/gyazo-mcp-server/config.toml、認証情報は ~/.config/gyazo-mcp-server/.env に配置する想定です。

config.toml:

tcp_port = 18449
oauth_callback_path = "/oauth/callback"
rust_log = "gyazo_mcp_server=info,rmcp=info"

.env:

GYAZO_MCP_OAUTH_CLIENT_ID=your-client-id
GYAZO_MCP_OAUTH_CLIENT_SECRET=your-client-secret
GYAZO_MCP_PERSONAL_ACCESS_TOKEN=your-personal-access-token

tcp_port、oauth_callback_path、rust_log は config.toml で管理し、GYAZO_MCP_OAUTH_CLIENT_ID と GYAZO_MCP_OAUTH_CLIENT_SECRET は .env で管理します。GYAZO_MCP_PERSONAL_ACCESS_TOKEN は簡易確認や個人利用向けの代替手段です。

一時的に設定を上書きしたい場合は、環境変数でも指定できます。tcp_port を一時的に変更する場合は、GYAZO_MCP_TCP_PORT を使用してください。

GYAZO_MCP_TCP_PORT=14861 gyazo-mcp-server stdio --auth

Gyazo OAuth Application

OAuth login を利用する場合は、Gyazo の開発者ページで OAuth Application を作成してください。

Gyazo のアプリケーション登録ページを開く
Application を作成し、client_id と client_secret を取得する
redirect_uri には http://127.0.0.1:<port><callback_path> を登録する
取得した値を GYAZO_MCP_OAUTH_CLIENT_ID と GYAZO_MCP_OAUTH_CLIENT_SECRET に設定する

既定値では redirect_uri は http://127.0.0.1:18449/oauth/callback です。config.toml の tcp_port または oauth_callback_path を変更する場合は、Gyazo 側に登録する redirect_uri も同じ値へ合わせてください。

まずローカルで動作確認したいだけであれば、Gyazo の開発者ページで発行できる Personal Access Token を GYAZO_MCP_PERSONAL_ACCESS_TOKEN に設定して利用することもできます。ただし、PAT で取得できるのは原則としてそのトークンを発行したユーザーに紐づく画像のみで、他ユーザーがアップロードした public 画像を取得する用途には向きません。また、PAT には OAuth login のようなユーザー認証文脈に基づく権限はないため、MCP login や user-scoped な認可の代替にはなりません。

Run

HTTP transport で起動する場合は次のとおりです。

gyazo-mcp-server

MCP endpoint は既定で http://127.0.0.1:18449/mcp です。

Codex や Claude Code から利用する場合は、この endpoint を MCP server URL として登録し、MCP login を実行してください。

stdio transport で起動する場合は次のとおりです。

gyazo-mcp-server stdio

stdio transport では MCP login を行えないため、事前に次のいずれかを満たしておく必要があります。

GYAZO_MCP_PERSONAL_ACCESS_TOKEN を設定しておく
先に HTTP transport 側で OAuth login を済ませ、保存済み token を作っておく

MCP login 非対応の client しか使えない場合は、先に one-shot の OAuth 認証だけ実行できます。

gyazo-mcp-server stdio --auth

このコマンドは一時的に callback 用のローカル HTTP サーバーを立てて、Gyazo OAuth を完了させたら token を保存して終了します。完了後は通常どおり gyazo-mcp-server stdio を client から起動してください。

stdio --auth を使う場合は、次の条件が必要です。

Gyazo OAuth の authorize URL を開けるブラウザ、または同等の認可手段があること
http://127.0.0.1:<port><callback_path> への callback を受け取れること

完全な非対話環境では、OAuth の代わりに GYAZO_MCP_PERSONAL_ACCESS_TOKEN を利用する方が現実的です。ただし、PAT は OAuth login のようなユーザー認証文脈の権限を持たないため、利用できる操作やアクセス範囲は限定されます。

Stdio Client Examples

Codex CLI

Codex CLI では、たとえば次のように TOML で設定できます。

[mcp_servers.gyazo]
command = "/home/yourname/.cargo/bin/gyazo-mcp-server"
args = ["stdio"]

stdio --auth を先に一度実行して token を保存しておくか、.env に GYAZO_MCP_PERSONAL_ACCESS_TOKEN を設定してください。

Claude Desktop / Claude Code

Claude Desktop や Claude Code 系では、たとえば次のように JSON で設定できます。

{
  "mcpServers": {
    "gyazo": {
      "command": "/home/yourname/.cargo/bin/gyazo-mcp-server",
      "args": ["stdio"]
    }
  }
}

こちらも、事前に gyazo-mcp-server stdio --auth を一度実行して token を保存しておくか、.env に GYAZO_MCP_PERSONAL_ACCESS_TOKEN を設定してください。

将来的な config や env などの拡張を見据えて、CLI は subcommand ベースになっています。

License

このリポジトリは MIT OR Apache-2.0 で提供します。詳細は LICENSE-MIT と LICENSE-APACHE を参照してください。

gyazo-mcp-server 0.2.0