# NHANES (design-correct survey analysis)

Сервер загружает данные NHANES с сайта CDC и считает статистики с учётом сложного дизайна выборки. Он помогает избежать смещённых оценок при эпидемиологическом анализе.

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

## Что делает

Обычный анализ NHANES без учёта стратификации и весов даёт смещённые оценки. Этот MCP-сервер загружает файлы с серверов CDC и объединяет их по ключу `SEQN`. Затем он автоматически выбирает аналитический вес и сохраняет его в `WT_ANALYSIS`. Фильтрация подвыборок через параметр `domain` сохраняет структуру дизайна, поэтому расчёт ошибок методом линеаризации Тейлора остаётся корректным.

Внутри доступно 17 инструментов. Они помогают искать переменные в кодовых книгах и перекодировать отказы через `set_missing`. Для таблиц с повторными записями предусмотрен `flag_from_long_table`, а для анализа риска есть взвешенная модель Кокса с данными Linked Mortality File. Поддерживаются циклы с 1999–2000 по 2021–2023 годы.

Для запуска нужен менеджер пакетов `uv`. Проект работает независимо от CDC, а пользователи обязаны соблюдать условия соглашения об использовании данных NCHS.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env NHANES_MCP_CACHE=<NHANES_MCP_CACHE> --env NHANES_MCP_DATA_DIR=<NHANES_MCP_DATA_DIR> --transport stdio nhanes-design-correct-survey-analysis -- uvx nhanes-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from nhanes-mcp <команда>

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- Загрузить и объединить циклы обследований NHANES по ключу `SEQN`
- Выбрать корректные веса выборки для лабораторных и диетических тестов
- Рассчитать доверительные интервалы Корна — Граубарда с флагами надёжности NCHS
- Построить взвешенную модель Кокса с подключением файла смертности

## Примеры запросов агенту
- Найди в NHANES переменные давления за 2017–2020 годы и рассчитай взвешенную распространённость гипертонии.
- Объедини циклы 2015–2018 годов, задай фильтр диабета через domain и выведи средний уровень глюкозы натощак.
- Построй взвешенную модель Кокса для связи индекса массы тела со смертностью по данным Linked Mortality File.

## Похожие
- [Zotero MCP](https://affpapa.org/nevibecode/mcp/zotero-mcp.md) — MCP-сервер · ★ 5585
- [arxiv-mcp-server](https://affpapa.org/nevibecode/mcp/arxiv-mcp-server.md) — MCP-сервер · ★ 3235
- [PaperBanana](https://affpapa.org/nevibecode/mcp/paperbanana.md) — MCP-сервер · ★ 2418
- [MATLAB MCP Server](https://affpapa.org/nevibecode/mcp/matlab-mcp-server.md) — MCP-сервер · ★ 1723
- [Hex Research](https://affpapa.org/nevibecode/mcp/hex-research.md) — MCP-сервер · ★ 584
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP-сервер · ★ 578

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