# gold-mcp

MCP-сервер отдаёт модели котировки XAUUSD, макротейп и корреляции по золоту, а платные уровни добавляют бэктест, SMC-сканер и расчёт риска.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: ThaiTrevor
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ThaiTrevor/gold-mcp
- Обновлён: 2026-08-31
- HTML: https://affpapa.org/nevibecode/mcp/gold-mcp

## Что делает

Бесплатный уровень даёт 13 инструментов: цену золота и его историю с Yahoo Finance, срез по DXY, доходностям, VIX и нефти, корреляционную матрицу и сезонность по дням недели. Отдельно работает связка по USD/VND с пересчётом мировой цены золота в донги — для сравнения с локальным вьетнамским курсом. Realtime-тики PAXG идут через публичный WebSocket Binance без ключа, а подключение своего MT5-терминала — через опциональный адаптер на Windows.

Pro, Premium и Ultra открывают TA по Боллинджеру и Ишимоку, бэктест четырёх стратегий с walk-forward проверкой, SMC-блоки (order blocks, FVG, sweeps, CHOCH/BOS), расчёт Kelly и risk of ruin, Monte Carlo для VaR и ИИ-брифинг на Anthropic. Эти уровни требуют лицензионный ключ `GOLD_MCP_LICENSE_KEY`, а AI Analyst дополнительно просит свой `ANTHROPIC_API_KEY` — сервер не хранит ни то, ни другое на своей стороне.

Для локальной сборки из исходников нужен Python 3.10+, но готовый пакет можно поставить и через `uvx` без клонирования репозитория.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `GOLD_MCP_LICENSE_KEY`, `ANTHROPIC_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add gold-mcp -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gold-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add gold-mcp --env GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx gold-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gold-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gold-mcp": {
            "command": "uvx",
            "args": [
                "gold-mcp"
            ],
            "env": {
                "GOLD_MCP_LICENSE_KEY": "<GOLD_MCP_LICENSE_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gold-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "gold-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "gold-mcp"
            ],
            "env": {
                "GOLD_MCP_LICENSE_KEY": "<GOLD_MCP_LICENSE_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gold-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GOLD_MCP_LICENSE_KEY=<GOLD_MCP_LICENSE_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> gold-mcp uvx gold-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gold-mcp <команда>

## Когда брать
- получить текущую цену и историю XAUUSD прямо в чате с моделью
- свести золото с DXY, доходностями и VIX в один макросрез
- посчитать сезонность и корреляции по золоту без своего скрипта
- прогнать бэктест или walk-forward стратегию по золоту
- найти order blocks, FVG и sweeps по методике Smart Money Concepts

## Примеры запросов агенту
- Покажи текущую цену золота и как она соотносится с сегодняшним DXY, доходностями и VIX
- Сделай снэпшот рынка золота: цена, макроконтекст, корреляции и сезонность по дням недели
- Прогони бэктест стратегии по золоту и покажи walk-forward результат

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md