# MANNA

MCP-сервер MANNA для Claude Code открывает доступ к астрономическим архивам IVOA. Ищет снимки и каталоги, исполняет запросы ADQL и сопоставляет названия объектов через Sesame.

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

## Что делает

Сервер связывает языковую модель с архивами NOIRLab Astro Data Lab, ALMA, CADC, ESO, Gaia, SDSS и любыми хранилищами из реестра IVOA. Внутри есть прямые вызовы TAP, SIA и cone search, а также комплексные сценарии, где агент за один шаг определяет координаты цели, выбирает архив и запускает поиск.

Небольшие ответы отдаются прямо в контекст. Крупные выборки TAP переводятся в асинхронные задачи: клиент получает ссылку и фрагмент кода на `pyvo` для загрузки. Между вызовами сервер состояние не хранит. Перед составлением запросов ADQL модель сверяется со встроенными подсказками по особенностям конкретных архивов.

Для работы нужен Python 3.12 или новее. Первый старт подтягивает библиотеки `astropy` и `pyvo`, из-за чего запуск занимает заметное время. Настройки передаются через переменные окружения с префиксом `MANNA_`, например `MANNA_ARCHIVES` или лимиты строк `MANNA_INLINE_ROW_LIMIT`.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env MANNA_ARCHIVES=<MANNA_ARCHIVES> --env MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS> --env MANNA_LOG_LEVEL=<MANNA_LOG_LEVEL> --env MANNA_INLINE_ROW_LIMIT=<MANNA_INLINE_ROW_LIMIT> --transport stdio manna -- uvx manna-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from manna-mcp <команда>

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- выполнять ADQL-запросы к астрономическим базам через TAP
- находить снимки объектов по координатам через SIA
- разрешать названия небесных тел в координаты через Sesame
- искать каталожные источники в заданном радиусе
- формировать код на pyvo для выгрузки больших массивов данных

## Примеры запросов агенту
- Найди снимки туманности Андромеды через SIA в архиве ESO
- Составь и выполни ADQL-запрос к Gaia DR3 для поиска звёзд в радиусе двух градусов от заданных координат
- Определи координаты объекта Betelgeuse через Sesame и проверь наличие наблюдений в ALMA

## Похожие
- [Cosmik — Live Space Data](https://affpapa.org/nevibecode/mcp/cosmik-live-space-data.md) — MCP-сервер · 147 установок
- [astropy](https://affpapa.org/nevibecode/skills/astropy.md) — скилл · 2100 установок
- [agenttime](https://affpapa.org/nevibecode/mcp/agenttime.md) — MCP-сервер · 1319 установок
- [astroai-research](https://affpapa.org/nevibecode/skills/astroai-research.md) — скилл · ★ 409 у репозитория

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

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