MCP stdio chạy cục bộ / signalint-mcp@0.2.0
Signalint chạy Oxlint, TypeScript và Biome ngay trong máy; phần việc không đổi được cache, lỗi lặp được gom lại, còn vòng lặp sửa–hỏng được cảnh báo trước khi phản hồi quay về coding agent.
npm install --save-dev signalint-mcp && npx signalint-mcp initFixture hiện tại: 9.151 B dữ liệu thô còn 1.233 B sau khi gom cụm.
Kết quả acceptance gần nhất; ngưỡng bắt buộc là dưới 300 ms.
Bốn mươi lỗi thô được thu về bốn cụm theo rule.
Số đường dẫn tương đối tối đa trong một lần gọi MCP.
01 / phản hồi
Cuộn qua fixture 40 lỗi để thấy các dòng đã chuẩn hóa trở thành phản hồi schema 1.1 có giới hạn rõ ràng.
Engine vẫn là nguồn sự thật. Signalint trước tiên chuẩn hóa vị trí, rule ID, severity và message.
Nhóm rule lớn trải trên nhiều file nhận một root-cause summary cùng các issue ID mẫu không trùng nhau.
Fixture kiểm soát giảm từ 9.151 byte còn 1.233 byte mà vẫn giữ trạng thái engine và tham chiếu issue.
02 / cơ chế
Signalint giữ engine chẩn đoán làm nguồn sự thật và biểu diễn rõ trạng thái cache, lỗi tiến trình cùng loop detection.
check_filesZod từ chối argument sai shape. Canonical path check giữ mọi file đã chấp nhận bên trong project root.
chấp nhận 3 đường dẫnEngine theo file chỉ nhận cache miss. TypeScript nhìn toàn bộ chương trình đã cấu hình khi file liên quan thay đổi.
Diagnostic riêng của engine trở thành normalized issue trước khi nhóm theo rule, gán priority và issue reference.
40 lỗi → 4 cụmSchema 1.1 giữ outcome của từng engine, nên một engine lỗi không xóa chẩn đoán từ engine khác.
schemaVersion 1.1Kết quả chỉ được dùng lại khi nội dung file, cấu hình engine, phiên bản Signalint và phiên bản engine vẫn trùng khớp.
sha256(nội dung file)
: engine
: hash cấu hình engine
: phiên bản signalint
: phiên bản engineMột lỗi biến mất rồi xuất hiện nhiều lần tạo cảnh báo hẹp, không suy diễn về toàn bộ cuộc trò chuyện của agent.
{
"signature": "no-unused-vars:<identifier> is unused",
"occurrences": 3,
"hint": "Lỗi này đã được sửa rồi quay lại 3 lần — nên thử cách khác"
}Một engine có thể lỗi mà không làm mất chẩn đoán engine khác đã hoàn thành.
"engines": {
"oxlint": { "status": "ok" },
"tsc": { "status": "error", "message": "..." },
"biome": { "status": "disabled" }
}Mặc định Oxlint 30 giây, tsc 120 giây và Biome 30 giây. Timeout hoặc hủy request đều kết thúc cây tiến trình.
SQLite cache loại hàng ít dùng nhất khi vượt 10.000 mục. Session log chỉ đọc phần đuôi gần nhất và giữ một bản .1 sau khi rotate.
03 / engine
Signalint điều phối ba công cụ mà không giả vờ chúng hoạt động giống nhau. Quyết định cache đi theo phạm vi thật của từng engine.
Phân tích theo file
Signalint gom các cache miss rồi lưu kết quả đã chuẩn hóa theo engine và file.
Phân tích toàn chương trình
Root thường dùng --project; root dạng solution có references dùng --build.
Theo file, bật tùy chọn
Mặc định tắt và luôn có trạng thái riêng trong mỗi check response.
04 / client
Một server cục bộ, ba vị trí cấu hình theo từng client. Lệnh init dò client ở gần và chỉ ghi file sau khi bạn xác nhận.
Chia sẻ MCP entry cục bộ qua .mcp.json.
claude mcp add --scope project signalint …Dùng .cursor/mcp.json cùng binary đã phát hành trên npm.
npx --no-install signalint-mcpĐặt working directory tuyệt đối trong mcp_config.json.
cmd /c npx --no-install signalint-mcp