Shadow-cljs Mcp

shadow-cljs-mcp

shadow-cljs のビルドを監視し、リアルタイムでビルド状況を更新する Model Context Protocol（MCP）サーバーです。

インストール

Cline／Cursor／Claude などの設定に以下を追加します。

{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}

サーバーの場所を指定する場合

{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp",
        "--host",
        "localhost",
        "--port",
        "9630"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}

--host と --port の引数は省略可能です。指定しない場合、サーバーは localhost:9630 に接続します。

概要

この MCP サーバーは、実行中の shadow-cljs インスタンスに接続し、ビルドの進行状況、失敗、完了を追跡します。LLM が ClojureScript ファイルの変更後にビルド状況を確認するための MCP ツールを提供します。

LLM との連携

LLM のメモへの追加

LLM のメモファイル（例：CLAUDE.md、cursorrules.md）に以下を追加します。

After any edits to ClojureScript files, use the shadow-cljs-mcp server's get_last_build_status tool to verify the build succeeded:

<use_mcp_tool>
<server_name>shadow-cljs-mcp</server_name>
<tool_name>get_last_build_status</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

This will show:
- Build status (completed/failed)
- Which files were compiled
- Any errors or warnings
- Build duration and metrics

ツールの応答例

ビルド成功：

{
  "status": "completed",
  "resources": 317,
  "compiled": 1,
  "warnings": 0,
  "duration": 0.609,
  "compiledFiles": [
    "path/to/your/file.cljs (505ms)"
  ]
}

ビルド失敗：

{
  "status": "failed",
  "message": "Build failed",
  "details": {
    // Error information
  }
}

使用上の注意

• LLM は ClojureScript ファイルを編集するたびに get_last_build_status を呼び出してください
• コンパイルエラーは、デバッグしやすいように詳細に表示されます
• ビルドが成功すると、コンパイルされたファイルと所要時間が表示されます
• このサーバーを起動する前に、shadow-cljs が実行中であることを確認してください

要件

• 実行中の shadow-cljs インスタンス（別途設定されていない場合、デフォルトは localhost:9630）