# faostat-mcp-server

Локальное зеркало FAOSTAT на SQLite: производство, торговля, продовольственная безопасность, выбросы по 245+ странам с 1961 года. Через MCP-инструменты агент сам находит домены, резолвит коды и гоняет SQL.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2410 установок · ★ 3 у репозитория
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/faostat-mcp-server
- Обновлён: 2026-10-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/faostat-mcp-server

## Что делает

Сервер поднимает статистику Продовольственной и сельскохозяйственной организации ООН прямо в агенте. Данные качаются из bulk-корпуса FAOSTAT в локальное SQLite-зеркало, поверх лежит DataCanvas: SQL-поверхность для больших выборок. Семь инструментов, один skill-ресурс.

Рабочий цикл такой: `faostat_list_domains` показывает каталог примерно из 69 статистических доменов со статусом индексации, `faostat_resolve_codes` превращает человеческие названия в целочисленные коды, а `faostat_query_observations` тянет куб по странам, товарам, элементам и годам. Мелкие результаты приходят инлайном, крупные уходят в таблицу DataCanvas, где их можно дочистить SQL-запросом. Флаги качества данных сохраняются в каждой строке.

Есть готовый workflow `faostat_commodity_profile`: по одному товару собирает топ производителей, тренд производства и торговые потоки. Для неоднозначных названий вроде maize или milk код лучше резолвить заранее через `faostat_resolve_codes` с доменом `QCL`. Таблицы DataCanvas живут 2 часа, `faostat_dataframe_drop` для досрочного удаления включается отдельно через `FAOSTAT_DATAFRAME_DROP_ENABLED=true`.

## Требования
- Удалённый сервер: `https://faostat-mcp-server--cyanheads.run.tools`

## Установка

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

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http faostat-mcp-server https://faostat-mcp-server--cyanheads.run.tools
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add faostat-mcp-server --url https://faostat-mcp-server--cyanheads.run.tools
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "faostat-mcp-server": {
            "url": "https://faostat-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "faostat-mcp-server": {
            "type": "http",
            "url": "https://faostat-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http faostat-mcp-server https://faostat-mcp-server--cyanheads.run.tools
```

## Когда брать
- найти нужный статистический домен FAOSTAT по коду или теме
- превратить название товара в код, который принимает запрос
- вытащить наблюдения по странам, товарам и годам
- собрать профиль товара: топ производителей, тренд, торговые потоки
- прогнать SQL по большим выборкам, не выгружая их из агента

## Примеры запросов агенту
- Покажи список доменов FAOSTAT, которые уже проиндексированы в локальном зеркале
- Найди код товара maize в домене QCL
- Собери профиль по кукурузе: топ производителей, динамику и экспорт

## Похожие
- [FAOSTAT MCP](https://affpapa.org/nevibecode/mcp/faostat-mcp.md) — MCP-сервер · ★ 20 у репозитория
- [data-scientist](https://affpapa.org/nevibecode/skills/data-scientist.md) — скилл · 385 установок
- [data-specialist](https://affpapa.org/nevibecode/agents/data-specialist.md) — субагент · ★ 328 у репозитория
- [data-analyst](https://affpapa.org/nevibecode/skills/borghei-data-analyst.md) — скилл · 629 установок
- [Statistics Canada MCP Server](https://affpapa.org/nevibecode/mcp/statistics-canada-mcp-server.md) — MCP-сервер · ★ 8 у репозитория
- [eurostat-mcp-server](https://affpapa.org/nevibecode/mcp/eurostat-mcp-server.md) — MCP-сервер · ★ 10 у репозитория

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