Shadow CLJS Build Monitor

🚀 shadow-cljs-mcp

このプロジェクトは、shadow-cljsのビルドを監視し、リアルタイムのビルド状態更新を提供するためのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

このサーバーを使用することで、shadow-cljsのビルド状態をリアルタイムで把握することができます。

📦 インストール

基本設定

次の内容をあなたの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）に追加してください。

ClojureScriptファイルを編集した後は、shadow-cljs-mcpサーバーのget_last_build_statusツールを使用してビルドが成功したかどうかを検証してください。

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

この操作により、次の情報が表示されます。
- ビルド状態（完了/失敗）
- コンパイルされたファイル
- エラーまたは警告
- ビルド時間とメトリクス

ツール応答の例

ビルド成功

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

ビルド失敗

{
  "status": "failed",
  "message": "Build failed",
  "details": {
    // エラー情報
  }
}

使用上の注意

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

前提条件

• 実行中のshadow-cljsインスタンス（デフォルトではlocalhost:9630に接続しますが、別途設定可能です）