Chạy trên máy bạn
Ứng dụng AI khởi chạy Vnstock MCP trên máy bạn; bảng đã lưu, nhật ký phiên và mã Python nằm trong thư mục nghiên cứu cá nhân.
Vnstock MCP · Chạy trên máy bạn
Đưa hệ sinh thái Vnstock vào ứng dụng AI bạn đang dùng
Vnstock MCP kết nối trợ lý AI với các thư viện Vnstock trên máy bạn. Bạn có thể bắt đầu bằng một câu hỏi tự nhiên, theo dõi từng lần dùng công cụ và lưu lại quy trình dưới dạng mã Python khi muốn kiểm tra hoặc chạy lại.
Cách một câu hỏi được xử lý
- Đặt câu hỏiBằng tiếng Việt tự nhiên ngay trong cuộc trò chuyện
- AI thấy đúng công cụDanh mục được lọc theo hồ sơ và quyền sử dụng hiện có
- Công cụ chạy cục bộVnstock xử lý từng phần việc trên hạ tầng của bạn
- Giữ lại cách làmNhật ký phiên và mã Python được xuất khi bạn yêu cầu
MCP là chuẩn kết nối để ứng dụng AI sử dụng công cụ bên ngoài. Vnstock MCP chạy trên máy bạn và gọi các thư viện trong hệ sinh thái theo quyền sử dụng hiện có. Dữ liệu được xử lý trên hạ tầng bạn chọn; một số kết nối có thể đi qua máy chủ chuyển tiếp khi cần bảo đảm tương thích hoặc ổn định. Nhật ký, bảng đã lưu và mã xuất theo yêu cầu nằm trong thư mục ~/vnstock_research.
Không chỉ dừng ở câu trả lời
Vnstock MCP giữ lại cấu trúc của phiên nghiên cứu để bạn biết công cụ nào đã chạy, dữ liệu nào đã được dùng và có thể tiếp tục công việc ngoài cuộc trò chuyện.
Chỉ hiện công cụ được dùng
Danh sách công cụ được lọc theo hồ sơ bạn chọn và quyền của tài khoản, giúp trợ lý tránh gọi nhầm chức năng ngoài phạm vi.
Từ cuộc trò chuyện thành mã chạy lại
Mỗi lần gọi được ghi vào nhật ký phiên. Khi yêu cầu, MCP có thể xuất quy trình thành tệp Python độc lập để bạn đọc và chỉnh sửa.
Nhận và đối chiếu bảng của bạn
Bạn có thể lưu bảng từ nguồn khác mình có quyền dùng, đối chiếu sai lệch và áp dụng phép tính Vnstock Quant trên cùng dữ liệu.
Ba việc có thể bắt đầu ngay
Liệt kê các mã trong rổ VN30, kèm ngành của từng mã.
- bảng dữ liệu
Lấy báo cáo kết quả kinh doanh 8 quý gần nhất của FPT, tính biên lợi nhuận gộp từng quý.
- bảng dữ liệu
- chỉ số tài chính
Tính chỉ báo RSI 14 phiên của HPG trong một năm qua và lưu bảng giá ra máy.
- chỉ báo kỹ thuật
- lưu file trên máy
"""Tái lập phiên nghiên cứu.
Mỗi khối lệnh tương ứng với một lần trợ lý AI gọi công cụ; bạn có thể tùy chỉnh và chạy lại độc lập bất cứ lúc nào.
"""
import pandas as pd
from vnstock import Market, cite
import vnstock_quant as vq
# c1 · market_equity
hpg_1y = Market().equity("HPG").ohlcv(length="1Y")
# c2 · quant_ta
c2 = vq.ta.compute(hpg_1y, "rsi", length=14)Khi một cách làm đã ổn, bạn có thể yêu cầu trợ lý xuất nhật ký phiên thành mã Python để đọc, chỉnh sửa hoặc chạy lại độc lập.
Bản Cộng đồng và bản Mở rộng
Cả hai bản sử dụng chung một gói cài đặt. Khi kết nối, MCP chỉ hiển thị những công cụ phù hợp với hồ sơ đã chọn và quyền sử dụng hiện có của tài khoản.
Bản Cộng đồngMiễn phí cho cá nhân, học tập và nghiên cứu
- Tra cứu thông tin nền tảng bằng các công cụ được mở cho bản Cộng đồng
- Dùng thử nhóm phép tính định lượng cơ bản theo hạn mức hiện hành
- Lưu bảng, đối chiếu dữ liệu, xem nhật ký và xuất mã Python để chạy lại
Bản Mở rộngTheo cấp tài trợ, từ Bronze tới Diamond
- Mở thêm công cụ theo cấp tài trợ và các thư viện đã được cài trên máy
- Mở rộng nhóm tính toán định lượng, rủi ro, danh mục và định giá theo quyền hiện có
- Giữ nguyên nhật ký, khả năng xuất mã Python và cách kết nối với ứng dụng AI
Phạm vi cụ thể phụ thuộc vào phiên bản thư viện, hồ sơ công cụ và quyền sử dụng hiện có. Khi quyền thay đổi, hãy khởi động lại ứng dụng AI để làm mới danh sách công cụ. Xem các gói tài trợ
Kết nối với ứng dụng của bạn
Sau khi hoàn tất cài đặt vnstock-mcp, bạn chỉ cần chạy một lệnh để in sẵn đoạn cấu hình chuẩn xác cho máy tính của mình.
Chạy lệnh dưới để tự động ghi cấu hình (hệ thống sẽ sao lưu tệp cũ). Khởi động lại Claude là có thể sử dụng ngay.
vnstock-mcp --setup claude-desktop --writeHoặc dán thủ công vào claude_desktop_config.json
{
"mcpServers": {
"vnstock": {
"command": "/Users/<tên-bạn>/.venv/bin/vnstock-mcp",
"args": []
}
}
}Các ứng dụng cài trên máy tính yêu cầu đường dẫn tuyệt đối; lệnh hướng dẫn ở trên đã tự động điền sẵn đường dẫn này cho bạn.
Những điều Vnstock MCP không làm
- Không phải bên cung cấp dữ liệu: Vnstock MCP gọi các công cụ phần mềm trên máy bạn; quyền sử dụng dữ liệu vẫn phụ thuộc vào từng nguồn.
- Không đưa ra khuyến nghị đầu tư: Câu trả lời của AI chỉ phục vụ mục đích nghiên cứu; hãy kiểm tra nguồn, đầu vào và phương pháp trước khi sử dụng.
- Phục vụ nghiên cứu cá nhân: Phần mềm được thiết kế để vận hành trên máy tính của bạn, không dùng để phân phối lại hay cung cấp dịch vụ cho bên thứ ba.
- Yêu cầu môi trường máy tính cục bộ: Không hoạt động trên ChatGPT bản web hoặc chế độ Chat thông thường, do các môi trường đám mây không thể kết nối tới máy cá nhân của bạn.
Công cụ MCP xử lý dữ liệu nghiệp vụ và lưu nhật ký nghiên cứu trên máy của bạn. Dịch vụ Vnstock xử lý tài khoản, giấy phép, thiết bị, hạn mức và các tín hiệu vận hành cần thiết; phạm vi cùng lựa chọn đo lường được mô tả trong Chính sách quyền riêng tư.
Cài đặt và kết nối
Cài đặt gói vnstock-mcp, chạy lệnh vnstock-mcp --setup cho ứng dụng AI của bạn, rồi khởi động lại ứng dụng để bắt đầu trò chuyện. Nếu gặp bất kỳ vướng mắc nào, bạn có thể chạy lệnh vnstock-mcp --doctor để tự động chẩn đoán hệ thống.