AI导哈

越南股票数据代理

一个提供越南股票市场数据的MCP服务器和CLI工具，集成AI工具支持多种金融数据分析功能。

  • by mrgoonie
  • Python
  • 本地部署
  • 104 星标
  • 更新于
在 GitHub 查看 mrgoonie/vnstock-agent

使用说明

VNStock代理商

MCP服务器和CLI用于越南股市数据。整合 vnstock 通过模型上下文协议（MCP）使用AI工具。

特性

  • 21个MCP工具 AI助手（Claude、GPT等）
  • 22个CLI命令 供终端使用
  • 3个MCP传输：stdio、SSE、流式HTTP
  • 越南股票、外汇、加密货币、世界指数、共同基金
  • 历史价格、财务状况、公司信息、交易数据

快速开始

安装

pip install vnstock-agent

或来源：

git clone https://github.com/mrgoonie/vnstock-agent.git
cd vnstock-agent
pip install -e .

设置API密钥

export VNSTOCK_API_KEY=your_api_key_here

在获取免费API密钥 vnstocks.com/登录.

命令行用法

# Stock history
vnstock-agent history VNM --start 2025-01-01 --end 2025-03-31

# Company overview
vnstock-agent overview FPT

# Financial statements
vnstock-agent balance-sheet VCB --period quarter
vnstock-agent income VCB --period annual
vnstock-agent cashflow VCB
vnstock-agent ratio VCB

# Market data
vnstock-agent symbols                    # All listed symbols
vnstock-agent group --group VN30         # VN30 stocks
vnstock-agent board "VNM,FPT,ACB,VCB"   # Price board
vnstock-agent industries                 # ICB industries

# Company details
vnstock-agent shareholders FPT
vnstock-agent officers FPT
vnstock-agent news FPT
vnstock-agent events FPT

# Intraday & depth
vnstock-agent intraday VNM --page-size 200

# Global markets
vnstock-agent fx EURUSD --start 2025-01-01
vnstock-agent crypto BTC --start 2025-01-01
vnstock-agent index DJI --start 2025-01-01

# Mutual funds
vnstock-agent funds

# JSON output
vnstock-agent --format json history VNM

MCP服务器

stdio（用于克劳德桌面、光标等）

添加到MCP客户端配置中：

{
  "mcpServers": {
    "vnstock": {
      "command": "vnstock-mcp",
      "env": {
        "VNSTOCK_API_KEY": "your_api_key_here"
      }
    }
  }
}

苏格兰和南方能源公司运输

VNSTOCK_MCP_TRANSPORT=sse VNSTOCK_MCP_PORT=8000 vnstock-mcp

可流式HTTP传输

VNSTOCK_MCP_TRANSPORT=http VNSTOCK_MCP_PORT=8000 vnstock-mcp

或者通过CLI：

vnstock-agent serve --transport sse --port 8000
vnstock-agent serve --transport http --port 8000

MCP工具

工具 说明
stock_history 历史OHLCV价格数据
stock_intraday 今日盘中交易数据
stock_price_depth 订单簿/买卖数据
company_overview 公司概况信息
company_shareholders 主要股东
company_officers 管理团队
company_news 公司新闻
company_events 股息、年度股东大会等。
financial_balance_sheet 资产负债表
financial_income_statement 损益表
financial_cash_flow 现金流量表
financial_ratio P/E、P/B、ROE、ROA等。
listing_all_symbols 所有列出的符号
listing_symbols_by_group VN30、HNX30等。
listing_symbols_by_exchange 通过交换（HOSE、HNX、UPCOM）
listing_industries ICB行业分类
trading_price_board 实时价格板
fx_history 外汇历史数据
crypto_history 加密货币数据
world_index_history 世界市场指数
fund_listing 共同基金上市

环境变量

变量 默认值 描述
VNSTOCK_API_KEY （none） VNStock API密钥
VNSTOCK_SOURCE VCI 默认数据源（VCI、KBS）
VNSTOCK_MCP_TRANSPORT stdio MCP传输（stdio、sse、http）
VNSTOCK_MCP_HOST 0.0.0.0 服务器主机
VNSTOCK_MCP_PORT 8000 服务器端口

发展

git clone https://github.com/mrgoonie/vnstock-agent.git
cd vnstock-agent
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

许可证

麻省理工学院

相关 MCP