# Chart Library — Market-state research

Даёт агенту доступ к завершённым торговым сессиям, историческим аналогам и опубликованным исследованиям с указанием источников. Пригодится, когда нужны цифры по рынку с оговорками, а не голая цитата.

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

## Что делает

Сервер открывает пять инструментов только на чтение. `market_state` возвращает состояние по завершённой сессии, аналоги из истории, разброс исходов и ленту сделок. `daily_note` отдаёт опубликованную дневную заметку, `research_quality` — калибровочную квитанцию с датированной выборкой. Ещё два инструмента работают с публикациями: `search_research` ищет по запросу, `read_research` читает документ по ID с пагинацией и хешами.

Подключение идёт по Streamable HTTP на `https://chartlibrary.io/mcp`, ключ не нужен. Для локального запуска есть пакет `chartlibrary-mcp` — нужен Python 3.10+ и MCP 1.x, версия `mcp` закреплена в диапазоне `>=1.28.1,<2.0.0`. Опциональный `CHART_LIBRARY_API_KEY` уходит Bearer-токеном; пустой ключ заголовок не отправляет.

Без даты запрос берёт последнюю собранную сессию, а не биржевую котировку в реальном времени. Даты — в формате `YYYY-MM-DD`. Исторические частоты не являются рекомендацией покупать или продавать, а проценты из `research_quality` относятся только к той выборке, что названа в квитанции. Сводки поиска — метаданные для навигации: прежде чем что-то утверждать, читайте сам документ.

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

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http chart-library https://chartlibrary.io/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env CHART_LIBRARY_API_KEY=<CHART_LIBRARY_API_KEY> --transport stdio chart-library-market-state-research -- uvx chartlibrary-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from chartlibrary-mcp <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add chart-library-market-state-research --url https://chartlibrary.io/mcp
```

2. **Командой платформы**
```bash
codex mcp add chart-library-market-state-research --env CHART_LIBRARY_API_KEY=<CHART_LIBRARY_API_KEY> -- uvx chartlibrary-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from chartlibrary-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chart-library-market-state-research": {
            "url": "https://chartlibrary.io/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chart-library-market-state-research": {
            "command": "uvx",
            "args": [
                "chartlibrary-mcp"
            ],
            "env": {
                "CHART_LIBRARY_API_KEY": "<CHART_LIBRARY_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from chartlibrary-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "chart-library-market-state-research": {
            "type": "http",
            "url": "https://chartlibrary.io/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "chart-library-market-state-research": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "chartlibrary-mcp"
            ],
            "env": {
                "CHART_LIBRARY_API_KEY": "<CHART_LIBRARY_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from chartlibrary-mcp <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http chart-library-market-state-research https://chartlibrary.io/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e CHART_LIBRARY_API_KEY=<CHART_LIBRARY_API_KEY> chart-library-market-state-research uvx chartlibrary-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from chartlibrary-mcp <команда>

## Когда брать
- получить состояние бумаги по завершённой сессии с историческими аналогами
- найти опубликованное исследование по теме и прочитать его источник
- сверить методику и размер выборки перед тем, как ссылаться на цифры
- посмотреть дневную заметку с правилом отбора за нужную дату
- вызвать те же данные из скрипта по HTTP без MCP-клиента

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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