gorosun/unified-diff-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

12 stars 7 forks 品質 55 トレンド 19NOASSERTION

Beautiful diff visualization for Claude Desktop. Transform code diffs into stunning visual comparisons with GitHub Gist integration and local file output.

概要

Beautiful diff visualization for Claude Desktop. Transform code diffs into stunning visual comparisons with GitHub Gist integration and local file output. - 🎨 using diff2html - 🌐 for instant sharing - 📁 (PNG/HTML) - 🔄 for temporary diffs - 🖥️ (Windows, macOS, Linux) - ⚡ with Bun runtime - 🛡️ with multi-level protection for shared diffs - 🔒 (Low/Medium/High) for different use cases 1. Go to GitHub Settings > Personal Access Tokens 2. Generate new token with gist scope 3. Add to your environment: When GitHub Token isn't available or for secure sharing, you can choose from multiple security levels: When GitHub Token is unavailable, the system falls back to local files: - HTML saved as temporary file - Automatic browser opening - Security-based file management For detailed setup and integration guides: - 🇺🇸 : CLAUDE_CODE_INTEGRATION.md - 🇯🇵 : CLAUDE_CODE_INTEGRATION_JP.md - (Primary) - (CLI) - - and other MCP clients

README

以下は原文 README の抜粋です。原文を見る。

Unified Diff MCP Server

Beautiful diff visualization for Claude Desktop. Transform code diffs into stunning visual comparisons with GitHub Gist integration and local file output.

✨ Features

🎨 Beautiful HTML diff visualization using diff2html
🌐 GitHub Gist integration for instant sharing
📁 Local file output (PNG/HTML)
🔄 Auto-delete functionality for temporary diffs
🖥️ Cross-platform support (Windows, macOS, Linux)
⚡ High-performance with Bun runtime
🛡️ Enhanced Security with multi-level protection for shared diffs
🔒 Multi-level security (Low/Medium/High) for different use cases

🚀 Quick Start

Installing via Smithery

bunx @smithery/cli install @gorosun/unified-diff-mcp --client claude --config '{
  "defaultAutoOpen": true,
  "defaultOutputMode": "html",
  "githubUsername": "your_actual_github_username",
  "githubToken": "ghp_your_actual_token_here"
}'

Manual Installation

Install Claude Desktop and Bun

Clone and build:

git clone https://github.com/gorosun/unified-diff-mcp.git
cd unified-diff-mcp
bun install

Configure Claude Desktop - see Configuration below

🛠️ Tools Overview

Tool	Purpose	Output	Best For
`visualize_diff_html_content`	Browser display & sharing	GitHub Gist + HTML preview URL	Quick sharing, instant viewing
`visualize_diff_output_file`	Local file storage	PNG/HTML files	Local storage, presentations

📖 Usage Examples

🎯 Optimal Prompts by Purpose

Purpose	Recommended Prompt	Tool Used	Output
Quick Preview	Please visualize and preview the following diff:``以下のdiffを可視化してプレビューしてください	`visualize_diff_html_content`	GitHub Gist + HTML preview URL
Local Storage	Please visualize and save the following diff to a file:``以下のdiffを可視化してファイルに保存してください	`visualize_diff_output_file`	Local HTML/PNG file
Share with Others	Please visualize the following diff and create a shareable link:``以下のdiffを可視化して共有リンクを作成してください	`visualize_diff_html_content`	GitHub Gist with shareable URL
Image Export	Please visualize and save the following diff as a PNG image:``以下のdiffを可視化してPNG画像で保存してください	`visualize_diff_output_file`	Local PNG image
Code Review	Please visualize the following diff in side-by-side format:``以下のdiffをside-by-side形式で可視化してください	Either tool	Side-by-side comparison

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "unified-diff-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/unified-diff-mcp/src/index.ts"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here",
        "DEFAULT_AUTO_OPEN": "true",
        "DEFAULT_OUTPUT_MODE": "html"
      }
    }
  }
}