chat-tool-ui-preview MCP server

chat-tool-ui-preview

AIエージェント（Claude Codeなど）がSlackに投稿する前に、その投稿を人が画面で確認するための小さなローカルツール。Go製の単体バイナリ chat-preview。

表示はSlackの画面を写したものではなく、本ツール独自のチャット風レイアウトです。書式（太字・引用・メンション・ブロックの並び）と文脈（宛先・スレッド返信かどうか・ボットとしてか）の意味が正しく伝わることを目的にしています。Slackのロゴ・配色・フォント・画面構成は使いません。本ツールはSlack Technologies, LLCが制作・提携・支援するものではありません。

何ができるか

• 入力形式3つ: 標準Markdown（Claude CodeのSlack連携のmessage）、Slack記法（mrkdwn）、Block Kit JSON
• 書式の描画: 太字／斜体／打消／コード／コードブロック／引用／リンク／メンション／日付／絵文字／箇条書き／表、Block Kitの section・header・divider・context・image・actions・rich_text
• 文脈の表示: 宛先、スレッド返信とチャンネルにも表示、送信主体（ユーザー／ボット）
• 自動検査の警告: 表示名が分からないメンション、未知の絵文字、長さ超過、不正・未対応のブロック
• Claude CodeのPreToolUseフックとして動き、Slack送信ツールの呼び出しに自動で割り込む。プレビューをブラウザで開いたうえで、判断はClaude Codeの通常の許可ダイアログに委ねる

やらないこと: Slackへの送信そのもの、Slack APIへの問い合わせ（トークンを持たない）、常駐、投稿内容の保存。画像やリンク先は読み込まない（投稿前に相手サーバーへアクセスが飛ぶのを避ける）。

インストール

chat-previewは実行時の依存を持たない単一の静的バイナリです。PATHの通った場所に置いてください。シェルも、Claude Codeのフックも、MCPクライアントも、同じchat-previewコマンドを呼びます。

# macOS／Linux
curl -fsSL https://raw.githubusercontent.com/gridhra/chat-tool-ui-preview/main/scripts/install.sh | sh
# Windows（PowerShell）。CIでクロスビルドはしていますが、Windowsの実機では未検証です
irm https://raw.githubusercontent.com/gridhra/chat-tool-ui-preview/main/scripts/install.ps1 | iex

スクリプトは、最新のGitHub ReleaseからOSとCPUに合うアーカイブを選び、そのSHA-256がリリースのchecksums.txtと一致しない限り何もインストールせず、chat-previewを~/.local/binに置きます。sudoは求めません。置き場所はCHATPREVIEWINSTALLDIR、バージョンはCHATPREVIEW_VERSIONで指定できます。更新はもう一度実行するだけです。

アーカイブが「このリポジトリのリリース用ワークフローが、タグの付いたソースからビルドしたもの」であることを確かめるには:

gh release download --repo gridhra/chat-tool-ui-preview --pattern '*darwin_arm64.tar.gz' --pattern checksums.txt
shasum -a 256 -c --ignore-missing checksums.txt
gh attestation verify chat-preview_*_darwin_arm64.tar.gz --repo gridhra/chat-tool-ui-preview

Goのツールチェーン（1.24以上）があるなら:

go install github.com/gridhra/chat-tool-ui-preview/cmd/chat-preview@latest

コンテナイメージとnpxランチャーは用意しません。ブラウザを開く必要があるので、ホストで動かすのが前提です。

Claude Desktopに入れる（MCP Bundle）

各リリースには、OSとCPUごとのchat-preview<版>.mcpbも付いています。MCP Bundle（.mcpb）は、manifest.jsonとバイナリを1つのzipにした配布形式で、Claude Desktop（macOS／Windows）がそのまま取り込めます。Releasesから自分のOSとCPUに合う.mcpbを落とし、ダブルクリック（またはClaude Desktopの設定 → エクステンション → 詳細設定 → エクステンションをインストール）で入ります。中身は上のアーカイブと同じバイナリで、checksums.txtとgh attestation verifyで同じように確かめられます。

macOSのClaude Desktopには、取り込んだバイナリの実行権限を落とす不具合（modelcontextprotocol/mcpb issue #294、2026-10-06時点で未修理）があるため、macOS用のバンドルは/bin/sh経由で起動して実行権限を付け直してからchat-preview mcpを実行します。Windows用は.exeを直接起動します。

同じバンドルを公式MCPレジストリにio.github.gridhra/chat-tool-ui-previewとして登録しています。レジストリから入れられるクライアントでは、その名前で探せます。

使い方

# 入力JSONをプレビューしてブラウザで開く
chat-preview preview input.json
echo '{"format":"mrkdwn","text":"*hi* <@U0AAA>","context":{"channel_id":"C0GEN","names":{"U0AAA":"aquila"}}}' | chat-preview preview

# 書式要素の見本を1枚で見る
chat-preview gallery

入力JSONの形:

{
  "target": "slack",
  "format": "markdown | mrkdwn | blocks",
  "text": "本文（markdown / mrkdwn のとき。blocks のときは通知用の代替文）",
  "blocks": [ ... ],
  "context": {
    "channel_id": "C0123", "channel_name": "general",
    "thread_ts": "1700000000.000100", "reply_broadcast": false,
    "as": "user | bot", "sender_name": "Deploy Bot",
    "names": { "U0123": "aquila", "C0123": "general" }
  },
  "source": "claude-slack-mcp | slack-web-api | manual"
}

formatは必須で、推定しません（標準MarkdownとSlack記法は bold の意味が違うため）。namesはID→表示名の対応表で、無いIDは「未解決」として警告に出ます。

Claude Codeとの連携（フック）

~/.claude/settings.json（または対象プロジェクトの.claude/settings.json）に:

Shortened. The full README is on GitHub.