Khắc phục lỗi

Bắt đầu với ping

Sau khi thay đổi cấu hình MCP client, hãy khởi động lại hoặc kết nối lại client và gọi ping với {}. Một kết nối stdio đang hoạt động sẽ trả về pong. Nếu quá trình khởi tạo kết thúc với EOF, hãy chạy lệnh server trong một terminal thông thường và xác nhận nó đang chờ ở stdin mà không in log thông thường ra stdout.

Windows command shims

Các MCP client chạy native trên Windows thường cần cmd /c xung quanh npx. Đối với Antigravity, sử dụng cấu trúc sau:

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

Đối với bản build phát triển npm-link có file shim .cmd bị lỗi, hãy bỏ qua shim:

node C:\duong-dan\tuyet-doi\den\Signalint\dist\src\index.js
node C:\duong-dan\tuyet-doi\den\Signalint\dist\src\cli.js stats

TypeScript không báo lỗi một cách bất ngờ

• Xác nhận có file tsconfig.json ở gốc dự án.
• Đối với monorepo, sử dụng cấu hình root kiểu solution với references trỏ tới các dự án composite.
• Chạy thủ công npx tsc --build cho cấu hình solution để so sánh hành vi trực tiếp của compiler.

check_files có vẻ như bị cũ (stale)

Quyết định hủy cache của tsc chỉ nhìn thấy các file được cung cấp rõ ràng cho cuộc gọi đó. Nếu file A thay đổi nhưng cuộc gọi chỉ kiểm tra file B không đổi phụ thuộc vào A, kết quả tsc trước đó có thể được tái sử dụng. Hãy đưa vào mọi file phụ thuộc đã thay đổi hoặc chạy check_project.

Một tham chiếu issue bị cũ

get_issue_detail chỉ tham chiếu tới kết quả thành công mới nhất. Hãy chạy check_project một lần nữa, sau đó sử dụng một clusterId hoặc issueId hiện tại.

Đặt lại trạng thái cục bộ

Dừng MCP server trước khi xóa .signalint/. Thư mục này chứa cache SQLite, trạng thái tăng dần của TypeScript và log phiên làm việc. Xóa thư mục trong khi tiến trình server vẫn đang chạy sẽ không làm sạch trạng thái vòng lặp trong bộ nhớ của tiến trình đó.

Kiểm tra lần check từ terminal

npx --no-install signalint check .

Để xem các số liệu được lưu trữ, hãy chạy npx --no-install signalint stats.