MCP サーバーリファレンス

miseru mcp は、AI エージェント(Claude Code など)から Miseru を直接操作するための MCP サーバーです。stdio で動作し、追加の依存はありません。

セットアップ

MCP クライアントの設定に次を追加します。

{
  "mcpServers": {
    "miseru": { "command": "npx", "args": ["-y", "miseru", "mcp"] }
  }
}

• 認証は環境変数 MISERU_TOKEN で行います(ツール呼び出し時に評価)。MCP サーバーを起動するプロセスに MISERU_TOKEN を渡してください
• MISERU_API で接続先を上書きできます(既定: https://api.miseru.dev)

Claude Code での具体的な連携手順は Claude Code 連携ガイドを参照してください。

ツール一覧

miseru_push

スクリーンショット画像を Miseru にアップロードし、GitHub PR に貼れる markdown を返します。PR への自動コメントは行いません(それは GitHub Action の役割です)。

パラメータ	型	必須	説明
file	string	✅	画像ファイルの絶対パス(png/jpg/webp、5MB 未満)
name	string	✅	論理名(例: home, login, checkout@mobile)
pr_number	integer	✅	対象 PR 番号
commit_sha	string	—	省略時はカレントの git HEAD を使用
viewport	string	—	例 1280x800

返り値(テキスト):

アップロード完了(id: <id>)

PR に貼る markdown:
![<name>](<配信URL>)

git リポジトリ外で commit_sha を省略した場合はエラーになります。

miseru_expire

アップロード済み画像を失効させます(オリジンから削除し、配信を止めます)。

パラメータ	型	必須	説明
image_id	string	✅	miseru_push が返した画像 id

返り値(テキスト): 失効しました: <image_id>

プロトコル仕様

• プロトコルバージョン: 2025-06-18
• capabilities: tools のみ(resources / prompts は未対応)
• サポートメソッド: initialize / tools/list / tools/call(notifications/* は応答なしで受理)
• 標準入力の不正な JSON 行は無視します(stdio ノイズ耐性)