Lịch sử phiên bản
Mở rộngBản Mở rộngvnstock_mcp v1.0.0Cập nhật
Mục lục
Nhãn [Mở rộng] đánh dấu phần chỉ có ở bản Mở rộng, nhãn [Cộng đồng] đánh dấu phần chỉ đúng với bản Cộng đồng. Phần không gắn nhãn đúng ở cả hai bản.
15-11-2026 (v1.0.0)
Bản chính thức đầu tiên cho thế hệ 6
vnstock-mcp 1.0.0 là bản chính thức của dòng 1.0, sau bốn bản thử nghiệm. Không đổi cách gọi công cụ so với 1.0.0rc4, chỉ thêm trường mới. Tài liệu: Vnstock MCP v1.
- Cài đặt:
pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock-mcp[quant]==1.0.0" "vnstock==6.0.1" "vnstock-oapi==0.1.2". Phụ thuộc:vnstock>=6.0.0,<7; phần[quant]đi cùngvnstock_quant1.0.0. - Hạn dùng: bản chính thức dùng được 365 ngày; bản thử nghiệm chỉ 30 ngày.
- Báo phiên nguồn hết hạn:
status,sourcesvàresearch_sourcescó thêm trườngneeds_logincùng lệnh mở lại phiên, thay vì báo nguồn vẫn dùng được. Công cụ vẫn hiện; mở lại phiên xong là gọi được ngay, không cần khởi động lại máy chủ. doctor --json: mọi lệnh đọc trạng thái đều xuất được JSON.- Bảng rỗng nói rõ: khi nguồn trả bảng rỗng, kết quả nêu rõ điều đó kèm gợi ý kiểm lại mã, khoảng ngày và nguồn, để trợ lý AI không kết luận sai.
- Phần giới thiệu gửi cho trợ lý AI gọn hơn: rút ngắn để ứng dụng như Claude Code không cắt mất phần trạng thái nguồn và cấp quyền.
13-11-2026 (v1.0.0rc4)
Hoàn thiện gói cài đặt 5 nền tảng và chuẩn hóa đầu ra v6
- Phát hành gói biên dịch sẵn trên cả 5 nền tảng: Xuất bản các bản dựng wheel cho macOS Apple Silicon (
arm64), macOS Intel (x86_64), Linux (x86_64vàaarch64) và Windows (x86_64) trên Python3.10–3.13, hoạt động đồng bộ cùngvnstock6.0.0,vnstock-oapi0.1.1vàvnstock_quant1.0.0. - Đồng nhất chuẩn dữ liệu
compat="v6": Tự động kích hoạt hồ sơ đầu rav6củavnstock6 trên toàn phiên làm việc (giá cổ phiếu, ETF, chứng quyền ởmarket_*,reference_*tính theo nghìn VND; chỉ số theo điểm; cột_percenttheo điểm phần trăm; thứ tự thời gian tăng dần) và ghi rõvnstock.compat.use("v6")khi kết xuất kịch bản Python quaresearch_journal. - [Mở rộng] Nâng cấp công cụ đo lường rủi ro
quant_risk: Hỗ trợ truyền thêm loại tài sản (asset) và khoảng nhìn lại (lookback); tự động áp dụng chỉ số chuẩnbenchmark="VNINDEX"riêng cho tài sản thị trường Việt Nam; tự động chuyển sang chuẩn năm hóa365ngày/năm và lược bỏlimit_hit_ratiođối với tài sản giao dịch cả cuối tuần như tiền mã hóa (crypto). - [Mở rộng] Chuẩn hóa mã tái lập và gợi ý tham số trong
quant_valuation: Ghi nhận đoạn mã tương đươngvq.valuation.call(method, ...)và bổ sung cơ chế bắt lỗi tên tham số viết tắt kèm gợi ý sửa trực tiếp (g→terminal_g,ke→r). - Thông báo lỗi có cấu trúc và nhận diện bảng nội bộ (
builtin): Trả về mãMCP_INVALID_ARGUMENT(kèm danh sách tham số hợp lệ) vàMCP_CHOICE_NOT_OPEN(phân biệt rõ trường hợp thiếu khóa nguồn Open API trên máy với quyền hạn tài khoản); ghi nhận rõ nguồn gốc cho các bảng danh mục có sẵn trongvnstock6 không gọi mạng và gắn ghi chú hướng dẫn chuyển đổi cho các bộ dữ liệu lưu từ bản0.xtrongresearch_datasets.
06-11-2026 (v1.0.0rc1)
Bản thử nghiệm đầu tiên cho thế hệ 6
- Chạy trên
vnstock6: dữ liệu qua Open API của nguồn, bằng khoá bạn đăng ký ở từng nguồn. Mọi tool dữ liệu nhậnsource; bỏ trống thì theo quy tắc nguồn bạn đã lưu. Tool dữ liệu hiện theo khoá nguồn trên máy, không theo cấp. Tài liệu: Vnstock MCP v1. - Tính toán và chạy thử: thêm
quant_backtest(một mã, danh mục, dò tham số, walk-forward, Monte Carlo, Sharpe đã hiệu chỉnh),quant_returns,quant_prices,quant_micro; các bước nối nhau bằngdatavàrefs, đi cùngvnstock_quant1.0.0rc1. - Nghiên cứu: thêm
research_sources,research_import(nhập tệp CSV, Excel, Parquet, JSON trên máy),research_pdf,research_bctc,research_vas(báo cáo tài chính dạng PDF); bỏresearch_normalize,research_benchmark,research_universe. - Dòng lệnh: lệnh
onboard,status,doctor,setup,sources,tools,call,workspace,servevà giao diện tương tác khi chạy trong terminal. - Kết quả: thêm
warningsmang cảnh báo của thư viện; lời gọi lâu báoStillRunningvà lần gọi lại chờ đúng phép tính đang chạy. - Hạn chế: ở bản
rc1mới có bản dựng cho macOS chip Apple; bản thử nghiệm dùng được 30 ngày. Chuyển từ bản 0.5: hướng dẫn.
12-10-2026 (v0.4.0)
Bản đầu tiên có tài liệu
- Cầu nối chạy cục bộ: Trợ lý AI trên máy bạn khởi chạy tiến trình
vnstock-mcptừ môi trường Python cá nhân; không có máy chủ trung gian đứng giữa. - Mã tham chiếu và mã Python tái lập: Mỗi kết quả lưu trong không gian làm việc cục bộ kèm mã
call_id(c1,c2...) và ghi vào nhật ký phiên.research_journal(method="script")xuất các bước đã chạy thành một tệp Python độc lập.
