LUCA CSS MCP Server

关键词

AI编码代理静态代码分析CSS 工具自动化工作流代码优化

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现一个 MCP 服务器（通过标准输入输出进行 JSON-RPC 通信），供 AI 编码代理调用 LUCA CSS 引擎的工具。核心功能包括：
      • css_compile：编译 CSS 配置为生产就绪的 CSS 产物
      • css_preflight：在编码前获取对语言相关的潜在风险与设计原则
      • css_scan：对代码进行静态扫描，返回检测到的错误与警告
    • 服务器并不会直接暴露完整引擎逻辑，而是通过 LUCA API 进行实际处理，服务器职责包括接收请求、路由工具调用、组装响应以及会话管理。

  • 主要功能点

    • JSON-RPC/STDIO 通信实现：接收 initialize、tools/list、tools/call、ping 等请求并返回对应响应
    • 工具集合：css_compile、css_preflight、css_scan（通过工具调用将参数转发给 LUCA API）
    • 安全与可扩展性：通过 HTTP 请求向 LUCA API 进行处理，支持配置 API 地址和密钥（通过本地配置或环境变量）并在请求头中传递
    • 配置与环境：默认 API 地址为 https://synthetic-context.net/css/api；支持自定义配置文件 ~/.luca/config.json，键值包括 api_url 与 api_key；环境变量 LUCA_API_URL 与 LUCA_API_KEY 也可覆盖默认设置

  • 安装步骤

    1. 安装依赖
      • 需要 Python（建议版本 3.x）
      • 安装依赖库 httpx（用于与 LUCA API 通信）
    2. 获取脚本
      • 获取并运行 luca_css_mcp.py（本仓库提供的脚本）
    3. 配置环境（可选）
      • 在 ~/.luca/config.json 中可以设置：
        • api_url：要使用的 LUCA CSS API 地址
        • api_key：可选的访问密钥
      • 也可以通过环境变量 LUCA_API_URL、LUCA_API_KEY 覆盖上述设置

  • 服务器配置（MCP 客户端需要的启动信息，示例仅供参考，实际路径需结合你的环境）

    • 服务器名称：luca-css
    • 启动命令：python3
    • 启动参数（args）：/path/to/luca_css_mcp.py
    • 说明：该配置使 MCP 客户端能够通过命令行启动该 MCP 服务器，并通过标准输入输出与之通信。服务器会在初始化时宣布支持的工具列表（css_compile、css_preflight、css_scan），并通过工具调用将请求转发给 LUCA CSS API 进行处理。若需要安全访问，请在 ~/.luca/config.json 中配置 api_url 与可选的 api_key，或设置相应的环境变量 LUCA_API_URL、LUCA_API_KEY。
    • 备注：MCP 客户端不需要理解服务器内部实现细节，只需按照上面的命令与参数启动并与之交互。

  • 基本使用方法

    1. 启动服务器
      • 使用 MCP 客户端按照配置启动该服务器进程，服务器将通过 STDIN/STDOUT 接收与发送 JSON-RPC 消息。
    2. 交互流程（示例逻辑由 MCP 客户端触发）
      • 客户端发送 initialize 请求，服务器返回协议版本、能力和服务器信息
      • 客户端请求 tools/list，服务器返回可用工具及其描述
      • 客户端通过 tools/call 调用具体工具（如 css_compile、css_preflight、css_scan），服务器将参数转发给 LUCA API，并将返回结果以 JSON-RPC 的形式发送回客户端
      • 客户端可通过 ping（心跳）检测服务器状态
    3. 运行与调试
      • 确保 LUCA API 可访问并正确配置了 api_url 和可选的 api_key
      • 如遇连接问题，服务器会返回错误信息，方便排查网络或认证问题

  • 相关配置（用于 MCP 客户端）

    • 服务器名称：luca-css
    • command: "python3"
    • args: ["/path/to/luca_css_mcp.py"]
    • 说明：上述配置用于 MCP 客户端在需要连接该 MCP 服务器时启动对应进程。启动后，MCP 客户端与服务器将通过标准输入输出进行 JSON-RPC 通信，调用工具并获取结果。

  • 重要注意

    • 该实现是一个服务器端，旨在为 AI 编码代理提供上下文和工具能力，实际的计算与分析逻辑由 LUCA API 提供并由服务器通过网络请求完成。

服务器信息

访问项目