Giới thiệu Vnstock MCP (Local)

Tài liệu này dành cho ai?

Dành cho các nhà đầu tư cá nhân, người mới bắt đầu lập trình và làm việc với AI (Claude Code, Antigravity, ChatGPT Codex, Claude Desktop, ChatGPT Desktop, Gemini Spark) muốn trang bị cho Trợ lý AI năng lực tra cứu dữ liệu chứng khoán Việt Nam, đọc Báo cáo tài chính, quản lý bảng nghiên cứu cục bộ và trải nghiệm các chỉ báo định lượng trong bản Cộng đồng (dành cho cá nhân, học tập và nghiên cứu).

Agent Guide

Tổng quan

vnstock-mcp bản Cộng đồng là một Cỗ máy nghiên cứu đầu tư cá nhân cục bộ (Local Personal Research Harness) chạy hoàn toàn trên máy tính của bạn, kết nối các Trợ lý AI (Claude Code, Antigravity, ChatGPT Codex, Claude Desktop, ChatGPT Desktop, Gemini Spark) với thị trường chứng khoán Việt Nam thông qua giao thức mở Model Context Protocol (MCP).

Hệ thống được thiết kế để chạy cục bộ (Local), hoàn toàn không phải là một dịch vụ máy chủ trực tuyến (online cloud service) hay API trung gian lưu trữ phát lại dữ liệu. Mọi dữ liệu phân tích, bảng tính và nhật ký tương tác đều được lưu giữ bảo mật ngay trên ổ cứng máy tính của bạn. Ở phiên bản này, bạn được cung cấp 26 công cụ cơ sở cùng hạn mức dùng thử định lượng 30 lượt/ngày, đủ để thực hiện các phiên phân tích cổ phiếu, tra cứu BCTC doanh nghiệp và xây dựng kịch bản nghiên cứu tái lập mà không cần trả bất kỳ khoản phí nào (miễn phí cho cá nhân, học tập và nghiên cứu).

Tuyên bố miễn trừ trách nhiệm (Disclaimer)

Các công cụ, dữ liệu và mô hình phân tích trong vnstock-mcp được cung cấp cho mục đích nghiên cứu thị trường, kiểm thử thuật toán và học tập trong môi trường cá nhân an toàn của người dùng. Mọi kết quả do Trợ lý AI sinh ra từ công cụ không cấu thành tư vấn đầu tư tài chính hay khuyến nghị giao dịch. Người dùng tự chịu trách nhiệm với các quyết định đầu tư thực tế.

Năng lực của Bản Cộng đồng

Bản Cộng đồng mang đến đầy đủ nền tảng nghiên cứu đầu tư khoa học với 4 trụ cột chính:

1. Tra cứu Dữ liệu Thị trường Cơ sở

Hồ sơ niêm yết: Tra cứu thông tin hơn 1.600 mã cổ phiếu trên 3 sàn (HOSE, HNX, UPCoM), phân loại theo ngành chuẩn ICB 4 cấp, danh sách rổ chỉ số VN30, HNX30.
Báo cáo tài chính: Đọc Bảng cân đối kế toán, Kết quả kinh doanh, Lưu chuyển tiền tệ theo quý hoặc năm.
Chỉ số tài chính cơ bản: Tra cứu P/E, P/B, EPS, ROE, ROA, biên lợi nhuận qua các kỳ.
Chỉ số vĩ mô & Tâm lý: Chỉ số vĩ mô cơ bản, dữ liệu mở tài khoản nhà đầu tư mới, thống kê thị trường.

2. Dùng thử Định lượng (30 lượt / ngày)

Tính toán các chỉ báo kỹ thuật phổ biến nhất: SMA, EMA, RSI, MACD, Bollinger Bands, ATR, Stochastic, OBV qua công cụ quant_ta_basic.
Tính toán các tỷ số tài chính cốt lõi trực tiếp trên BCTC qua quant_fa_basic.
Tính trên dữ liệu nến Vnstock hoặc dữ liệu bảng ngoài do bạn nhập vào.
Lượt dùng thử tự động làm mới vào 00:00:00 hàng ngày (giờ Việt Nam).

3. Nghiên cứu Tái lập & Đối chiếu Đa nguồn (Reproducible Harness)

Quản lý Ledger cục bộ: Lưu trữ bảng dữ liệu tạm thời trong bộ nhớ phiên, xuất ra file CSV/JSON trên máy.
Đối chiếu 2 nguồn dữ liệu: So sánh độ lệch giữa dữ liệu Vnstock và dữ liệu từ nguồn khác bạn có quyền dùng (ví dụ tệp Excel của bạn) qua công cụ research_diff.
Tự động sinh mã Python tái lập: Xuất toàn bộ quy trình mà bạn vừa tương tác với AI thành một script Python độc lập để chạy định kỳ (research_journal).

4. Cơ chế Lọc danh mục công cụ (Tool Filtering)

Lõi Rust nguyên khối tự động kiểm duyệt và chỉ hiển thị đúng 26 công cụ cơ sở cho Trợ lý AI.
Các công cụ nâng cao (chỉ báo TA chuyên sâu, mô hình tối ưu danh mục, đo lường rủi ro VaR, pipeline xuất AmiBroker) được ẩn khỏi danh mục công cụ của AI.
Hạn chế tình trạng Trợ lý AI gọi nhầm công cụ vượt cấp quyền, giúp giảm thiểu lỗi gián đoạn trong phiên tương tác.

Đối chiếu Bản Cộng đồng và Bản Mở rộng

Tiêu chí	Bản Cộng đồng	Bản Mở rộng (Tài trợ Bronze → Diamond)
Số lượng công cụ	26 công cụ cơ sở	33 đến 37 công cụ chuyên sâu
Chi phí	Miễn phí cho cá nhân, học tập và nghiên cứu	Tham gia các gói tài trợ dự án
Dữ liệu doanh nghiệp & BCTC	Đầy đủ 3 sàn	Đầy đủ 3 sàn
Lịch sử giá nến & Sổ lệnh	Nến cơ bản theo phiên	Đầy đủ nến OHLCV sâu, sổ lệnh độ sâu, dòng tiền tự doanh & khối ngoại
Lượt dùng thử Quant	30 lượt / ngày	Không đếm lượt dùng thử (tính vào hạn mức chung của tài khoản)
Chỉ báo kỹ thuật (TA)	Chỉ báo cơ bản (SMA, EMA, RSI, MACD...)	Đầy đủ 58+ chỉ báo chuyên sâu (Ichimoku, SuperTrend, VWAP, CMF, Keltner...)
Mô hình Quản trị Rủi ro	Chưa hỗ trợ	VaR, CVaR, Max Drawdown, Beta, Sharpe, Sortino
Tối ưu hóa Danh mục	Chưa hỗ trợ	Markowitz Efficient Frontier, Risk Parity, Black-Litterman (Gói Golden/Diamond)
Xuất dữ liệu AmiBroker	Chưa hỗ trợ	Pipeline tự động hóa xuất dữ liệu cho AmiBroker / Excel
Mã Python tái lập	Có	Có

Bắt đầu ngay

Xem Hướng dẫn Cài đặt và Kết nối để cấu hình Trợ lý AI trong 2 phút.
Nắm rõ Phân quyền và lượt dùng thử để khai thác hiệu quả 30 lượt tính toán hàng ngày.
Tra cứu Danh mục 26 Công cụ kèm câu lệnh mẫu dành riêng cho bạn.