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工具

环境变量

发展

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/

许可证

麻省理工学院