VN Stock API MCP Server

MCP server để tìm kiếm và truy cập API từ các công ty chứng khoán Việt Nam: VNDirect, FireAnt, và SSI.

Tính năng

• Tìm kiếm API documentation từ VNDirect, FireAnt, và SSI
• Lấy thông tin về API endpoints
• Truy cập documentation URLs
• Lấy giá cổ phiếu real-time từ FireAnt (get_stock_price_fireant)
• Liệt kê tất cả mã cổ phiếu Việt Nam (list_vn_stocks) - tương tự list_assets trong coincap-mcp
• Lấy tin tức thị trường chứng khoán từ CafeF (get_cafef_market_news) - sử dụng Firecrawl API để scrape tin tức
• Phân tích mô hình nến Doji (analyze_doji_pattern) - phân tích kỹ thuật để phát hiện tín hiệu đảo chiều

Cài đặt

Cách 1: Clone từ GitHub (Khuyến nghị)

# Clone repository
git clone https://github.com/Long0308/vn-stock-api-mcp.git
cd vn-stock-api-mcp

# Cài đặt dependencies và build
npm install
npm run build

Cách 2: Sử dụng trực tiếp từ GitHub (đã có sẵn dist/)

Nếu bạn chỉ muốn sử dụng mà không cần phát triển, bạn có thể clone và sử dụng trực tiếp:

# Clone repository
git clone https://github.com/Long0308/vn-stock-api-mcp.git
cd vn-stock-api-mcp

# Chỉ cần cài đặt dependencies (dist/ đã có sẵn)
npm install

Cấu hình trong mcp.json

Cấu hình với đường dẫn local (sau khi clone)

Cấu hình cơ bản (không có Firecrawl API):

{
  "mcpServers": {
    "vn-stock-api-mcp": {
      "command": "node",
      "args": [
        "C:\\path\\to\\vn-stock-api-mcp\\dist\\index.js"
      ]
    }
  }
}

Cấu hình đầy đủ (có Firecrawl API để sử dụng tính năng get_cafef_market_news):

{
  "mcpServers": {
    "vn-stock-api-mcp": {
      "command": "node",
      "args": [
        "C:\\path\\to\\vn-stock-api-mcp\\dist\\index.js"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "your-firecrawl-api-key-here"
      }
    }
  }
}

Cấu hình với đường dẫn tương đối

{
  "mcpServers": {
    "vn-stock-api-mcp": {
      "command": "node",
      "args": [
        "~/vn-stock-api-mcp/dist/index.js"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "your-firecrawl-api-key-here"
      }
    }
  }
}

Lưu ý:

• Thay C:\\path\\to\\vn-stock-api-mcp hoặc ~/vn-stock-api-mcp bằng đường dẫn thực tế đến thư mục bạn đã clone.
• Thay "your-firecrawl-api-key-here" bằng API key thực tế của bạn từ firecrawl.dev (chỉ cần nếu muốn sử dụng tính năng get_cafef_market_news).
• Nếu không có Firecrawl API key, các tool khác vẫn hoạt động bình thường, chỉ có get_cafef_market_news sẽ sử dụng phương pháp fallback.

Tools có sẵn

1. search_vn_stock_api

Tìm kiếm API documentation từ các nhà cung cấp.

Parameters:

• provider: “vndirect” | “fireant” | “ssi” | “all”
• query (optional): Từ khóa tìm kiếm

2. get_api_endpoints

Lấy danh sách API endpoints cho một nhà cung cấp.

Parameters:

• provider: “vndirect” | “fireant” | “ssi”
• category (optional): Lọc theo category

3. get_api_documentation_urls