Vnstock Logo

Vnstock MCP thế hệ 6

Thử nghiệm

Mục lục

Bản thử nghiệm, chưa phát hành chính thức

Trang này viết cho vnstock_mcp v1.0.0rc1, bản thử nghiệm. Tên hàm, tham số và cột dữ liệu có thể còn đổi trước ngày phát hành; khi cài, ghi rõ số phiên bản như ở trang Cài đặt. Bản đang phát hành chính thức là v0.4.0, xem tài liệu bản đó.

vnstock-mcp là máy chủ MCP chạy trên máy tính của bạn. Trợ lý AI bạn đang dùng (Claude Desktop, ChatGPT desktop, Gemini, Claude Code, Codex, Antigravity, VS Code, Cursor) khởi chạy nó như một chương trình trên máy, rồi gọi các hàm của bộ công cụ Vnstock thế hệ 6 thay vì tự đoán số liệu:

  • vnstock 6 truy xuất dữ liệu từ Open API của nguồn, bằng khoá do chính bạn đăng ký ở nguồn đó;
  • vnstock_quant tính chỉ báo kỹ thuật, chỉ số tài chính, rủi ro, danh mục, giá điều chỉnh, vi cấu trúc thị trường và chạy thử chiến lược;
  • mỗi bước trợ lý làm được ghi thành một dòng mã Python. Cuối buổi, bạn xuất cả phiên thành một script tự chạy lại được, không cần trợ lý AI.

vnstock-mcp là phần mềm tương tác: nó không tự kết nối nguồn nào và không nhận khoá của nguồn. Truy xuất dữ liệu là việc của vnstock 6 chạy trên máy bạn; tính toán là việc của vnstock_quant. Kết quả được trả cho ứng dụng AI bạn đang dùng, và ứng dụng đó xử lý tiếp theo chính sách của nó.

Bản thử nghiệm 1.0.0rc1

Đây là bản thử nghiệm đầu tiên cho thế hệ 6, đi cùng vnstock 6.0.0rc3, vnstock-oapi 0.1.0rc2 và vnstock_quant 1.0.0rc1. Bản thử nghiệm dùng được 30 ngày kể từ ngày dựng; khi gần hết hạn, máy chủ nhắc bạn cập nhật. Bản dựng sẵn hiện chỉ có cho macOS chip Apple. Phần nào đã chạy thật, phần nào còn hạn chế: xem Mức hoàn thiện.

Bản này có gì

PhầnBạn làm được gì
Dữ liệu qua vnstock 621 tool tra cứu và thị trường: danh mục mã, hồ sơ doanh nghiệp, lịch sự kiện, giá cổ phiếu, chỉ số, ETF, phái sinh, chứng quyền, quỹ mở, tiền mã hoá, ngoại tệ, hàng hoá, chỉ số quốc tế, bảng giá nhiều mã, khớp lệnh, báo cáo tài chính. Mọi tool nhận source để bạn chọn nguồn
Tính toán bằng vnstock_quant58 chỉ báo kỹ thuật, 100 chỉ số tài chính có công thức, thước đo rủi ro, bảng lợi suất nhiều mã, tối ưu danh mục, định giá theo mô hình, giá điều chỉnh theo sự kiện doanh nghiệp, vi cấu trúc trên dữ liệu khớp lệnh
Chạy thử chiến lượcBacktest một mã và danh mục theo luật thị trường Việt Nam (lô, bước giá, biên độ, chu kỳ thanh toán, thuế bán), bảng quy tắc trên chỉ báo, dò tham số, walk-forward, Monte Carlo, Sharpe đã hiệu chỉnh cho nhiều lần thử
Nối các bước không chép sốMỗi kết quả có call_id (c1, c2…). Bước sau nhận bảng của bước trước bằng data hoặc refs, nên số liệu dài không phải đi qua cuộc trò chuyện
Tái lậpNhật ký phiên, lưu bảng đầy đủ ra máy, xuất script Python của cả phiên
Bảng của bạnNhập tệp CSV, Excel, Parquet, JSON có sẵn trên máy để tính tiếp như bảng lấy qua vnstock
Báo cáo tài chính dạng PDFĐọc tệp PDF trên máy, bóc bảng, chuẩn hoá về chỉ tiêu VAS, kiểm phương trình kế toán, lập hồ sơ phân tích
Dòng lệnhGiao diện tương tác khi chạy trong terminal; lệnh setup nối vào từng ứng dụng AI, doctor kiểm máy, call gọi thử một tool

Điều kiện sử dụng

  • Dùng được từ bản Cộng đồng, miễn phí cho cá nhân, học tập và nghiên cứu. Bạn không cần đăng nhập để dùng phần dữ liệu và các tool nghiên cứu.
  • Dữ liệu theo khoá của bạn, không theo cấp. Một tool dữ liệu hiện ra khi máy bạn có khoá của một nguồn đọc được nó, hoặc nguồn đó không cần khoá. Chưa có khoá thì phần đó chỉ thiếu khoá, không phải bị khoá theo cấp.
  • Tính toán theo cấp quyền của vnstock_quant. Bản Cộng đồng có 10 chỉ báo, 10 chỉ số tài chính cơ bản và backtest cơ bản theo lượt thử trong ngày; các nhóm khác mở theo cấp quyền của Gói quyền sử dụng Vnstock. Bảng chi tiết: Quyền dùng và hạn mức của vnstock_quant.
  • Chỉ chạy trên máy bạn. Máy chủ nói chuyện với ứng dụng AI qua stdio, hoặc qua HTTP trên địa chỉ loopback của chính máy. Không có chế độ mở ra mạng ngoài.
Không phải khuyến nghị đầu tư

Kết quả tính toán và chạy thử chiến lược là số liệu tham khảo để bạn tự phân tích. Kết quả chạy thử trên dữ liệu quá khứ không phải lợi nhuận kỳ vọng. Dữ liệu đến từ nguồn bên thứ ba mà bạn có quyền truy cập; hãy tự kiểm tra trước khi dùng cho quyết định của mình.

Một buổi làm việc trông thế nào

Bạn hỏi trợ lý: "So sánh rủi ro FPT, VCB, HPG một năm qua và thử chiến lược SMA10 cắt SMA30 trên HPG". Trợ lý gọi lần lượt:

  1. quant_returns lấy giá ba mã qua vnstock và dựng bảng lợi suất: c1.
  2. quant_portfolio tính ma trận hiệp phương sai trên c1: c2.
  3. quant_backtest với eval_rule_dsl dịch luật SMA10 cắt SMA30 thành tín hiệu trên giá HPG: c3.
  4. quant_backtest với run_backtest nhận tín hiệu từ c3 qua refs: c4.
  5. research_journal(method="script") xuất bốn bước trên thành một tệp Python.

Mỗi câu trả lời của trợ lý đi kèm code của bước đó và provenance ghi nguồn đã dùng, thời điểm lấy, phiên bản thư viện. Bạn đọc lại, sửa, chạy lại script như mã của chính mình.

Đọc tiếp

Tags

vnstock_mcp
thế hệ 6