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

Vào https://www.finhay.com.vn/finhay-skills → Đăng nhập → Tạo API Key.

Bạn sẽ nhận được:

Chọn một trong ba cách sau:

Mở Terminal (macOS) hoặc PowerShell (Windows), dán lệnh sau và nhấn Enter:

macOS:

Terminal

curl -fsSL https://raw.githubusercontent.com/finhay/mcp-server/main/install.sh | bash

Windows (PowerShell):

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.

Nếu bạn đã có Node.js (>= 18), chạy lệnh sau:

Terminal

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.

Bước 3a. Tạo file credentials tại ~/.finhay/credentials/.env:

Code

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

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.

Mở Claude, hỏi:

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

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...