Vnstock Logo

Lịch sử phiên bản

Mở rộngvnstock_mcp v1.0.0

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ùng vnstock_quant 1.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, sources và research_sources có thêm trường needs_login cù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_64 và aarch64) và Windows (x86_64) trên Python 3.10–3.13, hoạt động đồng bộ cùng vnstock 6.0.0, vnstock-oapi 0.1.1 và vnstock_quant 1.0.0.
  • Đồng nhất chuẩn dữ liệu compat="v6": Tự động kích hoạt hồ sơ đầu ra v6 của vnstock 6 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 _percent theo đ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 qua research_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ẩn benchmark="VNINDEX" riêng cho tài sản thị trường Việt Nam; tự động chuyển sang chuẩn năm hóa 365 ngà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 đương vq.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 trong vnstock 6 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ản 0.x trong research_datasets.

06-11-2026 (v1.0.0rc1)

Bản thử nghiệm đầu tiên cho thế hệ 6

  • Chạy trên vnstock 6: 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ận source; 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ằng data và refs, đi cùng vnstock_quant 1.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, serve và giao diện tương tác khi chạy trong terminal.
  • Kết quả: thêm warnings mang cảnh báo của thư viện; lời gọi lâu báo StillRunning và lần gọi lại chờ đúng phép tính đang chạy.
  • Hạn chế: ở bản rc1 mớ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-mcp từ 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.