finhay-mcp-server
<!-- mcp-name: io.github.finhay/mcp-server -->MCP Server cho Finhay Securities — xem giá cổ phiếu, danh mục đầu tư, vàng, crypto qua Claude AI.
Cài đặt
Bước 1: Tạo API Key
Vào https://www.finhay.com.vn/finhay-skills → Đăng nhập → Tạo API Key.
Bạn sẽ nhận được:
- API Key:
ak_live_xxx - API Secret:
sk_live_yyy
Bước 2: Kết nối với Claude
Chọn một trong ba cách sau:
Cách 1: Cài đặt tự động (không cần Node.js — khuyên dùng)
Mở Terminal (macOS) hoặc PowerShell (Windows), dán lệnh sau và nhấn Enter:
macOS:
curl -fsSL https://raw.githubusercontent.com/finhay/mcp-server/main/install.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/finhay/mcp-server/main/install.ps1 | iex
Script sẽ tự động cài Node.js (nếu chưa có), hỏi API Key/Secret, và cấu hình Claude Desktop.
Cách 2: Cài đặt nhanh (cần Node.js)
Nếu bạn đã có Node.js (>= 18), chạy lệnh sau:
npx -y finhay-mcp-server --install
Script sẽ hỏi API Key/Secret (Secret được ẩn bằng dấu *), tự động ghi config vào Claude Desktop.
Cách 3: Cấu hình thủ công
Bước 3a. Tạo file credentials tại ~/.finhay/credentials/.env:
FINHAY_API_KEY=ak_live_xxx
FINHAY_API_SECRET=sk_live_yyy
Bước 3b. Thêm vào file config Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Windows (Microsoft Store):
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
{
"mcpServers": {
"finhay": {
"command": "npx",
"args": ["-y", "finhay-mcp-server"]
}
}
}
API Key/Secret không nằm trong file config Claude — được lưu riêng tại
~/.finhay/credentials/.env(dùng chung với Finhay Skills).
Sau khi hoàn tất, khởi động lại Claude Desktop là xong.
Bước 3: Sử dụng
Mở Claude, hỏi:
- "Giá cổ phiếu VNM hôm nay?"
- "Xem danh mục đầu tư của tôi"
- "So sánh FPT và VNM"
- "Giá vàng SJC hôm nay bao nhiêu?"
- "Lãi suất tiết kiệm ngân hàng nào cao nhất?"
- "Chỉ số CPI Việt Nam gần đây?"
Tools
Thị trường (20 tools)
| Tool | Mô tả |
|---|---|
get_stock_realtime | Giá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn) |
get_news | Sự kiện doanh nghiệp (cổ tức, quyền mua, ĐHĐCĐ...) |
get_price_history_chart | Lịch sử giá OHLCV (1D/5/15/30/1H/4H) |
get_recommendation_reports | Báo cáo phân tích từ chuyên gia |
get_gold_prices | Giá vàng (SJC, DOJI, PNJ, BTMC) |
get_gold_chart | Biểu đồ giá vàng |
get_gold_providers | Giá vàng theo nhà cung cấp |
get_silver_prices | Giá bạc |
get_silver_chart | Biểu đồ giá bạc |
get_metal_providers | Giá vàng + bạc theo nhà cung cấp |
get_all_financial_data | Tổng hợp: vàng, bạc, crypto, lãi suất, tỷ giá |
get_bank_interest_rates | Lãi suất tiết kiệm ngân hàng |
get_crypto_top_trending | Crypto xu hướng |
get_market_data | Dữ liệu chỉ số global (SP500, Nikkei...), big-tech, hàng hoá, forex |
get_economic_calendar_events | Sự kiện kinh tế sắp tới (CPI, họp Fed, PMI...) |
get_company_financial_overview | Tổng quan tài chính doanh nghiệp (PE, PB, ROE, EPS...) |
get_company_financial_analysis | Phân tích tài chính theo năm/quý |
get_financial_statement | Báo cáo tài chính (BCTC, CDKT, LCTT) |
get_macro_data | Chỉ số vĩ mô (CPI, PMI, IIP, FED rate...) |
get_market_session | Trạng thái phiên giao dịch |
Tài khoản (8 tools)
| Tool | Mô tả |
|---|---|
get_account_summary | Số dư: tiền mặt, chứng khoán, ký quỹ |
get_asset_summary | Tổng tài sản |
get_portfolio | Danh mục cổ phiếu với lãi/lỗ |
get_pnl_today | Lãi/lỗ hôm nay |
get_order_history | Lịch sử lệnh |
get_order_book | Sổ lệnh trong ngày |
get_order_detail | Chi tiết 1 lệnh |
get_user_rights | Quyền cổ đông: cổ tức, quyền mua... |
Yêu cầu
- Node.js >= 18
- Tài khoản Finhay Securities với API Key