Spring AI Playground - Ứng dụng desktop hỗ trợ từ viết công cụ MCP đến kiểm thử và tích hợp bên ngoài

Xin chào.

Gần đây, ngày càng có nhiều trường hợp viết và sử dụng mã công cụ MCP (Model Context Protocol) với sự hỗ trợ của các AI agent như Claude Code hay Cursor. Tuy nhiên, khi thực sự muốn chạy thử và kiểm chứng mã công cụ đã viết trong môi trường thực tế, thường có không ít lúc gây bức bối.

• Công cụ này có thực sự hoạt động đúng không?
• Khi agent gọi công cụ thì chính xác những tham số nào đã được truyền vào, và nếu xảy ra lỗi thì nguyên nhân là gì? (Chỉ với UI cửa sổ chat thì việc debug gần như là một hộp đen.)
• Nếu muốn tái sử dụng công cụ này trong dự án khác hoặc trên các client bên ngoài như Claude Desktop thì sao? Cuối cùng vẫn phải thiết lập lại backend server từ đầu.

Để giải quyết những bất tiện này, tôi đã tạo ra Spring AI Playground — một Tool Lab cục bộ cho phép chạy thử ngay mã công cụ MCP đã viết, debug một cách minh bạch, và xuất bản trực tiếp cho các client bên ngoài.

✨ Tính năng chính

• Tool Studio: Chỉ cần copy-paste logic công cụ JavaScript đã viết, có thể chạy ngay mà không cần kiến thức về Java hay Spring
• MCP server tích hợp sẵn: Có thể kết nối và tái sử dụng ngay các công cụ đã được kiểm chứng với các client tương thích MCP như Claude Desktop, Cursor, v.v. (thay đổi được phản ánh ngay lập tức)
• MCP Inspector: Xem chi tiết giá trị đầu vào, đầu ra, schema, log thực thi và lỗi
• Agentic Chat: Liên kết công cụ do chính bạn tạo với local Vector DB (RAG) để kiểm thử tức thời trong một UI chat hợp nhất
• Quản lý secret: Quản lý an toàn trong môi trường kho lưu trữ secret của desktop để không phải hardcode API key trong script

Ứng dụng được cung cấp dưới dạng desktop đa nền tảng (Windows, macOS, Linux), và bạn có thể sử dụng ngay trên máy cục bộ chỉ bằng cách tải file cài đặt mà không cần Docker hay cài đặt JVM riêng.

Tôi hy vọng đây sẽ là một môi trường làm việc hữu ích cho những ai, giống như tôi, từng cảm thấy phiền toái vì việc thiết lập backend hoặc bức bối vì kiểu debug hộp đen trong quá trình tạo và kiểm thử công cụ MCP.

🔗 Liên kết

• Tải xuống (Windows/macOS/Linux): GitHub Releases
• Tài liệu (Docs): Documentation
• Kho mã (Repo): GitHub

Không chỉ dừng ở việc viết mã công cụ, nếu bạn có thể chia sẻ phản hồi và ý kiến về cách hiện tại bạn đang debug từ góc nhìn vận hành và kiểm chứng thực tế thì tôi sẽ rất cảm kích!