Color Palette Generator MCP App

AIチャット内にインタラクティブなカラーパレット生成UIを埋め込むMCP Appです。

セットアップ

pnpm install

起動方法

# UIビルド + サーバー起動
pnpm start

サーバーが http://localhost:3001/mcp で起動します。

開発モード（ホットリロード）

pnpm dev

Claude Desktopへの接続

~/Library/Application Support/Claude/claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "color-palette": {
      "command": "/opt/homebrew/bin/npx",
      "args": ["tsx", "/path/to/mcp-apps/main.ts", "--stdio"]
    }
  }
}

設定後、Claude Desktopを再起動してください。

HTTP経由で接続する場合

pnpm serve

で起動後、http://localhost:3001/mcp に接続します。

動作確認（curl）

# initializeリクエスト
curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

# パレット生成
curl -X POST http://localhost:3001/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"generate-palette","arguments":{"baseColor":"#3498db","paletteType":"analogous"}}}'

ツール

ツール名	説明
generate-palette	ベースカラーからパレットを生成（complementary, analogous, triadic, monochromatic, split-complementary）
check-contrast	2色間のWCAGコントラスト比を計算

新しいMCP Appプロジェクトを作る

このプロジェクトの構成をベースに、新しいMCP Appをスキャフォールドするスキルを用意しています。

Claude Code上で以下を実行してください。

/skill dev_init-mcp-app my-new-app

サーバー・クライアント・Viteバンドル・デュアルトランスポート（stdio + HTTP）の雛形が一括生成されます。

技術スタック

• @modelcontextprotocol/ext-apps 1.0.1
• @modelcontextprotocol/sdk 1.26.0
• zod 4.x
• Vite + vite-plugin-singlefile
• TypeScript