Cài đặtv0.2.0 / schema 1.1

Cài đặt & client

Cài đặt Signalint, tạo cấu hình mặc định tự động phát hiện theo dự án, kết nối Claude Code, Cursor hoặc Antigravity và xác minh kết nối stdio.

Cài đặt trong dự án được kiểm tra

Chạy thiết lập ngay từ dự án JavaScript hoặc TypeScript mà Signalint sẽ kiểm tra. Cần Node.js 20.19+ hoặc 22.12+; kiểm tra TypeScript cũng yêu cầu một file tsconfig.json ở gốc dự án.

npm install --save-dev signalint-mcp
npx signalint-mcp init

init phát hiện những gì

npx signalint-mcp init kiểm tra dự án trước khi ghi bất cứ file nào. Lệnh chỉ bật TypeScript khi có file tsconfig.json gốc, bật Biome khi file cấu hình của nó tồn tại và sử dụng Oxlint làm mặc định khi không tìm thấy linter đã cấu hình.

Dấu hiệu phát hiện	Hành vi được tạo
File `tsconfig.json` gốc	Bật adapter tsc kiểm tra toàn bộ chương trình (whole-program).
Cấu hình Oxlint	Bật adapter Oxlint kiểm tra theo từng file (file-local).
`biome.json` hoặc `biome.jsonc`	Bật adapter Biome kiểm tra theo file tùy chọn.
Một MCP client ở gần duy nhất	Đề nghị bổ sung cấu hình server Signalint sau khi xác nhận.
Nhiều hoặc không có client rõ ràng	Hỏi bạn muốn dùng client nào hoặc in ra đoạn snippet chính xác để copy.

Cấu hình Signalint thủ công

Nếu không sử dụng init, hãy tạo signalint.config.json ở gốc dự án. Mọi trường được hỗ trợ đều được giải thích chi tiết trong tài liệu tham khảo cấu hình.

{
  "engines": {
    "oxlint": true,
    "tsc": true,
    "biome": false
  },
  "ignore": ["node_modules/**", "dist/**", ".signalint/**"],
  "timeoutsMs": {
    "oxlint": 30000,
    "tsc": 120000,
    "biome": 30000
  }
}

Claude Code

Project scope tạo file .mcp.json có thể chia sẻ. Trên macOS hoặc Linux:

claude mcp add --scope project signalint -- npx --no-install signalint-mcp
claude mcp get signalint

Trên Windows native, bọc npx bằng cmd /c:

claude mcp add --scope project signalint -- cmd /c npx --no-install signalint-mcp
claude mcp get signalint

Để biết về hành vi phạm vi và xử lý lỗi phía client, xem tài liệu MCP của Claude Code.

Cursor

Tạo file .cursor/mcp.json trong dự án được kiểm tra:

{
  "mcpServers": {
    "signalint": {
      "command": "npx",
      "args": ["--no-install", "signalint-mcp"]
    }
  }
}

Trên Windows native, đặt "command": "cmd" và "args": ["/c", "npx", "--no-install", "signalint-mcp"]. Mở cài đặt MCP của Cursor và bật signalint. Xem tài liệu MCP của Cursor để biết vị trí cấu hình và kiểm soát trạng thái.

Antigravity

Antigravity thường lưu cấu hình trên Windows tại %USERPROFILE%\.gemini\antigravity\mcp_config.json. Init có thể cập nhật cấu hình này sau khi bạn xác nhận. Cấu hình thủ công tương đương trên Windows là:

{
  "mcpServers": {
    "signalint": {
      "command": "cmd",
      "args": ["/c", "npx", "--no-install", "signalint-mcp"],
      "cwd": "<duong-dan-tuyet-doi-den-project-cua-ban>"
    }
  }
}

Trên macOS hoặc Linux, sử dụng "command": "npx" với ["--no-install", "signalint-mcp"]. Luôn đặt cwd thành gốc dự án tuyệt đối, sau đó kết nối lại hoặc khởi động lại Antigravity.

Xác minh kết nối

Khởi động lại hoặc kết nối lại MCP client sau khi cấu hình thay đổi.
Gọi ping với {} và xác nhận kết quả trả về là pong.
Gọi check_project với { "paths": ["."] }.

Signalint ghi các dữ liệu cache và phiên làm việc vào .signalint/. Giữ thư mục này ngoài verson control.

Xác minh không cần MCP client

npx --no-install signalint check .

Lệnh sẽ thoát với mã exit 1 khi phát hiện chẩn đoán; đó là hành vi kiểm tra bình thường thay vì lỗi CLI.