shadow-cljs-mcp

shadow-cljs-mcp

site icon
2025.04.16 1
JavaScript构建监控开发工具开发效率
shadow-cljs-mcp 是一个基于 Model Context Protocol (MCP) 的服务,主要用于监控 shadow-cljs 的构建过程,并提供实时的构建状态更新。它能够帮助开发者或大型语言模型(LLM)在修改 ClojureScript 文件后验证构建状态,从而提高开发效率。
View on GitHub

Overview

基本能力

产品定位

shadow-cljs-mcp 是一个专门用于监控和报告 shadow-cljs 构建状态的 MCP 服务器,旨在为开发者和 LLM 提供实时的构建反馈。

核心功能

  • 实时监控 shadow-cljs 的构建进度、失败和完成状态。
  • 提供 get_last_build_status 工具,用于获取最后一次构建的详细状态。
  • 显示构建状态(完成/失败)、编译的文件、错误或警告信息以及构建时长和指标。

适用场景

  • 在修改 ClojureScript 文件后,验证构建是否成功。
  • 快速定位和调试构建过程中的错误。
  • 集成到 LLM 的工作流程中,自动化构建状态检查。

工具列表

  • get_last_build_status: 获取最后一次构建的详细状态,包括构建状态、编译的文件、错误或警告信息以及构建时长和指标。

常见问题解答

  • 确保 shadow-cljs 实例正在运行,否则服务器无法连接。
  • 如果未配置 --host--port 参数,服务器将默认连接到 localhost:9630

使用教程

使用依赖

  • 需要安装 Node.js 和 npm。
  • 确保 shadow-cljs 实例正在运行。

安装教程

  1. 在 Cline/Cursor/Claude 设置中添加以下配置:
{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}
  1. 可选配置服务器位置:
{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp",
        "--host",
        "localhost",
        "--port",
        "9630"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}

调试方式

  1. 启动 shadow-cljs-mcp 服务器。
  2. 使用 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>
  1. 根据返回的 JSON 数据判断构建状态和错误信息。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。