Saltar al contenido
MCP ThesaurusMCP Thesaurus

finhay

ArchivadoIncomplete39/100Reclamar

npm finhay-mcp-serverstdioupdated 2mo ago

MCP Server cho Finhay Securities — xem giá cổ phiếu, danh mục đầu tư, vàng, crypto qua Claude AI.

Su propietario archivó este repositorio. Sigue funcionando, pero ya no recibe actualizaciones.

CódigoWeb

¿Qué puedes hacer con finhay?

finhay-mcp-server

Tiếng Việt | English

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