Local stdio MCP / signalint-mcp@0.4.2
Signalint là MCP server chạy qua stdio cục bộ thực thi Oxlint, TypeScript và Biome (tùy chọn)—sau đó cache phần việc chưa đổi, gom cụm lỗi lặp lại và phát hiện vòng lặp sửa lỗi trước khi trả phản hồi có phiên bản cho 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.
Lần chạy acceptance gần nhất; trần tối đa là 300 ms cho fixture 50 file.
Bốn mươi lỗi thô được gom thành bốn cụm theo rule.
Số đường dẫn tương đối tối đa được chấp nhận 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.2 có giới hạn rõ ràng.
Các engine luôn giữ quyền phán quyết. Signalint chuẩn hóa vị trí, mã rule, mức độ nghiêm trọng và thông điệp trước.
Nhóm rule lớn trải rộng nhiều file nhận một tóm tắt nguyên nhân gốc và danh sách mẫu issue ID riêng biệt.
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.2 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.2Kế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 dao động; lỗi lặp lại trên cùng file qua nhiều lần check tạo cảnh báo churn hẹp.
{
"signature": "no-unused-vars:<identifier> is unused",
"occurrences": 3,
"hint": "This issue was fixed and reappeared 3 times — consider a different approach"
}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ộ, bốn 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-mcpDùng chung giữa ChatGPT desktop app, Codex CLI và IDE extension qua config.toml.
codex mcp add signalint -- npx --no-install signalint-mcp