内容
# VIMO 金融智能 — MCP 服务器
> 🦉 越南最全面的金融数据和 AI 分析平台，通过模型上下文协议（MCP）访问。
[](https://www.npmjs.com/package/@vimo.cuthongthai.vn/mcp-server)
[](https://opensource.org/licenses/MIT)
## 快速开始
### 1. 获取 API 密钥（免费）
访问 [vimo.cuthongthai.vn/finance/ai/api-docs](https://vimo.cuthongthai.vn/finance/ai/api-docs) → 创建密钥 → 复制。
或使用演示密钥：`vimo_demo_public_readonly_2026`（限速，仅限 VN30）
### 2. 连接到 Claude Desktop
在 `~/.claude/claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"vimo": {
"command": "npx",
"args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
"env": {
"VIMO_API_KEY": "vimo_demo_public_readonly_2026"
}
}
}
}
```
**Claude 代码：**
```bash
claude config add-mcp vimo-financial-intel -- env VIMO_API_KEY=vimo_demo_public_readonly_2026 npx -y @vimo.cuthongthai.vn/mcp-server
```
**Cursor：** 在 `~/.cursor/mcp.json` 中添加：
```json
{
"mcpServers": {
"vimo": {
"command": "npx",
"args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
"env": {
"VIMO_API_KEY": "vimo_demo_public_readonly_2026"
}
}
}
}
```
**Windsurf / Cline：** 在 MCP 设置中添加：
```json
{
"command": "npx",
"args": ["-y", "@vimo.cuthongthai.vn/mcp-server"],
"env": { "VIMO_API_KEY": "vimo_demo_public_readonly_2026" }
}
```
### 3. 向 Claude 询问越南股票信息
```
"FPT 今天的价格是多少？"
"分析 VCB 的技术指标"
"筛选增长型股票"
"AI 预测这个月的胜率？"
"原油价格上涨的最佳商品策略？"
```
## 可用工具（35）
### L0：发现（3）
| 工具 | 描述 |
|------|-------------|
| `search_stocks` | 按名称或代码搜索越南股票 |
| `get_stock_info` | 公司概况 + 最新价格 + 关键财务比率 + 护城河评分 |
| `get_realtime_quote` | 来自 SSI FastConnect 的实时价格 + 外资流向 + 可选 1 分钟 K 线 |
### L1：上下文（5）
| 工具 | 描述 |
|------|-------------|
| `get_index_history` | VNINDEX/VN30/HNX30 每日 OHLCV 历史数据 |
| `get_macro_snapshot` | 越南 + 全球宏观经济指标（央行利率、CPI、GDP、PMI） |
| `get_foreign_flow` | 外资投资者净买入/卖出 — top 10 股票 |
| `get_sector_rotation` | 行业热度图 — 日涨幅排名靠前的行业 |
| `get_warwatch_osint` | WarWatch 地缘政治风险评分 + 伊朗-霍尔木兹石油风险 |
### L2：筛选（2）
| 工具 | 描述 |
|------|-------------|
| `screen_stocks` | 股票筛选器 — 13 种内置策略（增长、价值、分红等） |
| `get_sector_rotation` | 行业轮动热度图 |
### L3：分析（6）
| 工具 | 描述 |
|------|-------------|
| `get_price_history` | 任意股票的每日 OHLCV 价格历史数据 |
| `get_financials` | 资产负债表、损益表、现金流、比率 |
| `get_technical_signals` | 技术指标：RSI、MACD、均线交叉、成交量 |
| `get_ta_narrative` | 越南股票的技术分析 + AI 叙述 |
| `get_bctc_summary` | 财务报表分析（ROE、Z-Score、5 种策略） |
| `get_factor_importance` | 每只股票的因子重要性分析 |
### L4：验证（5）
| 工具 | 描述 |
|------|-------------|
| `get_opinion` | 分析师共识 + AI 推荐 |
| `get_insider_activity` | 内幕交易记录 |
| `get_corporate_events` | 分红、股东大会、配股 |
| `get_whale_activity` | 异常成交量股票（>2 倍均值）— 机构信号 |
| `get_ai_performance` | AI 选股胜率和表现指标 |
### L5：决策（1）
| 工具 | 描述 |
|------|-------------|
| `get_news_sentiment` | 每只股票的新闻情绪评分 — 看涨/看跌/中立 |
### L8：学习 — 投资策略（13）
| 工具 | 描述 |
|------|-------------|
| `get_bank_rate_playbooks` | 利率场景策略 |
| `get_bds_playbooks` | 房地产投资策略 |
| `get_commodity_playbooks` | 大宗商品影响分析 |
| `get_dong_tien_playbooks` | 资金流向（外资、机构、散户） |
| `get_fund_playbooks` | ETF 和共同基金比较 |
| `get_gia_toc_playbooks` | 企业 dynasty 分析 |
| `get_investment_checklists` | 投资前尽职调查 |
| `get_macro_playbooks` | 宏观经济场景策略 |
| `get_political_playbooks` | 政治阿尔法（政策影响） |
| `get_psychology_playbooks` | 交易心理学 |
| `get_sector_rotation_playbooks` | 行业轮动策略 |
| `get_warwatch_playbooks` | 地缘政治风险策略 |
| `get_wealth_playbooks` | 个人财富管理 |
## 安全
- 🔒 **需要 API 密钥** — 服务器在没有有效 `VIMO_API_KEY` 的情况下拒绝启动
- 🔑 **密钥格式验证** — 必须匹配 `vimo_[a-zA-Z0-9]{32+}` 或 `vimo_demo*`
- ⏱️ **30 秒请求超时** — 防止连接挂起
- 🛡️ **12 层防御** — 服务器端（限速、输入净化、金丝雀检测）
- 🧹 **输入净化** — 符号和类别在发送前验证
## 数据覆盖
- **约 2,000 只越南股票**（HOSE、HNX、UPCOM）
- **50+ 数据源**（SBV、GSO、SSI FastConnect、FMP、Yahoo、Binance）
- **实时价格** — 通过 SSI FastConnect（市场时间延迟 15 分钟）
- **每日更新**（ICT 时间 6:00 AM） — 基本面、信号和 AI 选股
## 速率限制
| 层级 | 每日调用次数 | 每分钟调用次数 | 价格 |
|------|-----------|-----------|-------|
| 演示 | 50 | 3 | 免费 |
| 免费 | 100 | 5 | $0/月 |
| 开发者 | 1,000 | 10 | $19/月 |
| 专业 | 3,000 | 20 | $49/月 |
| 企业 | 无限制 | 60 | $299/月 |
在 [vimo.cuthongthai.vn/finance/ai/api-docs](https://vimo.cuthongthai.vn/finance/ai/api-docs) 获取您的 API 密钥
## 环境变量
| 变量 | 是否必需 | 默认值 | 描述 |
|----------|:--------:|---------|-------------|
| `VIMO_API_KEY` | **是** | — | 您的 VIMO API 密钥 |
| `VIMO_API_BASE` | 否 | `https://vimo.cuthongthai.vn` | API 基地址 |
## 其他可用资源
- **REST API**: `GET https://vimo.cuthongthai.vn/api/mcp/realtime-quote?symbol=FPT` (+ `x-api-key` 头部)
- **MCP 清单**: `https://vimo.cuthongthai.vn/api/mcp/manifest.json` (35 个工具)
- **发现**: `/.well-known/mcp.json`, `/llms.txt`
- **LLM 信息**: `https://vimo.cuthongthai.vn/llms.txt`
## 许可证
MIT — © CuThongThai 2026
