1. Conduid
  2. Blockchain
  3. io.github.finhay/mcp-server
MCP server · Blockchain

io.github.finhay/mcp-server

by · github.com/finhay/mcp-server

Finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI

Unclaimed blockchain
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.finhay/mcp-server

io.github.finhay/mcp-server is an MCP server published by finhay in the Blockchain category: finhay Securities — stock prices, portfolio, gold, crypto, and macro data via AI.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add io-github-finhay-mcp-server -- npx -y finhay-mcp-server
npx
npx -y finhay-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (20)

get_all_financial_dataTổng hợp: vàng, bạc, crypto, lãi suất, tỷ giá

Parameters not published.

get_bank_interest_ratesLãi suất tiết kiệm ngân hàng

Parameters not published.

get_company_financial_analysisPhân tích tài chính theo năm/quý

Parameters not published.

get_company_financial_overviewTổng quan tài chính doanh nghiệp (PE, PB, ROE, EPS...)

Parameters not published.

get_crypto_top_trendingCrypto xu hướng

Parameters not published.

get_economic_calendar_eventsSự kiện kinh tế sắp tới (CPI, họp Fed, PMI...)

Parameters not published.

get_financial_statementBáo cáo tài chính (BCTC, CDKT, LCTT)

Parameters not published.

get_gold_chartBiểu đồ giá vàng

Parameters not published.

get_gold_pricesGiá vàng (SJC, DOJI, PNJ, BTMC)

Parameters not published.

get_gold_providersGiá vàng theo nhà cung cấp

Parameters not published.

Show all 20 tools
get_macro_dataChỉ số vĩ mô (CPI, PMI, IIP, FED rate...)

Parameters not published.

get_market_dataDữ liệu chỉ số global (SP500, Nikkei...), big-tech, hàng hoá, forex

Parameters not published.

get_market_sessionTrạng thái phiên giao dịch

Parameters not published.

get_metal_providersGiá vàng + bạc theo nhà cung cấp

Parameters not published.

get_newsSự kiện doanh nghiệp (cổ tức, quyền mua, ĐHĐCĐ...)

Parameters not published.

get_price_history_chartLịch sử giá OHLCV (1D/5/15/30/1H/4H)

Parameters not published.

get_recommendation_reportsBáo cáo phân tích từ chuyên gia

Parameters not published.

get_silver_chartBiểu đồ giá bạc

Parameters not published.

get_silver_pricesGiá bạc

Parameters not published.

get_stock_realtimeGiá cổ phiếu realtime (1 mã, nhiều mã, hoặc theo sàn)

Parameters not published.

Ask AI

✦

Ask AI about io.github.finhay/mcp-server

Powered by Claude · Grounded in docs

I know everything about io.github.finhay/mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.finhay/mcp-server

How do I install io.github.finhay/mcp-server?

Run claude mcp add io-github-finhay-mcp-server -- npx -y finhay-mcp-server, then add the server to your MCP client's configuration.

Is io.github.finhay/mcp-server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.finhay/mcp-server still maintained?

Yes — the last commit was 4 months ago. The repository has 0 stars and 0 forks.