English Français العربية

MANNA

Registre officiel Autres

MCP server for IVOA astronomical archives: NOIRLab Astro Data Lab, NRAO/ALMA, CADC, ESO, Gaia

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package manna-mcp
Claude Code 
claude mcp add manna -e 'MANNA_ARCHIVES=<MANNA_ARCHIVES>' -e 'MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS>' -e 'MANNA_LOG_LEVEL=INFO' -e 'MANNA_INLINE_ROW_LIMIT=200' -- uvx manna-mcp==0.11.0 --stdio
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "manna": {
            "command": "uvx",
            "args": [
                "manna-mcp==0.11.0",
                "--stdio"
            ],
            "env": {
                "MANNA_ARCHIVES": "<MANNA_ARCHIVES>",
                "MANNA_ALLOWED_HOSTS": "<MANNA_ALLOWED_HOSTS>",
                "MANNA_LOG_LEVEL": "INFO",
                "MANNA_INLINE_ROW_LIMIT": "200"
            }
        }
    }
}

Variables d'environnement

  • MANNA_ARCHIVES Comma-separated archive short_names to activate (e.g. 'datalab,alma'). Unset means all.
  • MANNA_ALLOWED_HOSTS Comma-separated hostnames the server may fetch. Unset means any public host.
  • MANNA_LOG_LEVEL Logging verbosity.
  • MANNA_INLINE_ROW_LIMIT Max rows returned inline before a result is promoted to an async job or truncated.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. MANNA
  2. Installation
  3. Connect a client
  4. Configuration
  5. Development
  6. License

MANNA

MANNA (MCP Architecture for NOIRLab, NRAO, and additional Archives) is an MCP server that gives LLM clients such as Claude Code, Claude Desktop, and Jupyter AI access to astronomical archives through the standard IVOA interfaces: TAP/ADQL, SIA image search, cone search, the IVOA registry, and Sesame name resolution. It includes curated notes for NOIRLab Astro Data Lab, ALMA, CADC, ESO, Gaia, and SDSS, and can reach any archive listed in the IVOA registry.

Its tools fall into four groups:

  • Connections call the IVOA interfaces directly: resolve a target name, run an ADQL query, search for images or catalog sources by position, search the registry.
  • Workflow tools do a multi-step task in one call: resolve a target, pick an archive, run the search or count.
  • Result handling returns small results inline. A large TAP result becomes an async job, and the client receives a result URL and a pyvo snippet to fetch it. The server keeps nothing between requests.
  • Archive notes record each archive's quirks (missing columns, enum values, spatial-index hints) so the model sees them before writing ADQL. Every note has a check that re-verifies it.

Full documentation, including the reference for every tool, is at https://manna.readthedocs.io.

Installation

Python 3.12 or later. The PyPI distribution is manna-mcp; the import package and the command are both manna.

uvx manna-mcp --stdio        # run without installing: MCP over stdio
pip install manna-mcp        # or install it; `manna` then serves HTTP on :8000

The first launch downloads astropy and pyvo, which takes a while. Run uvx manna-mcp --stdio once in a terminal before adding it to a client with a short startup timeout.

The Docker image and the MCP Registry entry are described under Installation.

Connect a client

Claude Code:

claude mcp add manna -- uvx manna-mcp --stdio

Claude Desktop, or any client with a JSON config:

{"mcpServers": {"manna": {"command": "uvx", "args": ["manna-mcp", "--stdio"]}}}

For a shared HTTP server or Jupyter AI, run manna and point the client at http://localhost:8000/mcp/.

Guides: Claude Code, Claude Desktop, Jupyter AI, a first query.

Configuration

All settings are optional and are read from MANNA_* environment variables or a .env file. The two most often changed:

  • MANNA_ARCHIVES=datalab,alma limits which archives have curated notes. Unset means every archive except nrao, which is inactive until named here.
  • MANNA_INLINE_ROW_LIMIT=2000 and MANNA_INLINE_BYTE_LIMIT=262144 raise the inline result caps from their small-model defaults to suit a large context window such as Claude's.

Every setting is listed in the configuration guide. Adding or removing an archive is covered in the archives guide.

Development

git clone https://github.com/NSF-Simons-CosmicAI-Institute/manna
cd manna
uv sync
uv run pytest --record-mode=none   # offline replay of recorded archive traffic
uv run python -m manna             # server on http://localhost:8000

Feature branches are cut from dev and merged back by pull request. Tests, linting, recorded cassettes, the docs build, and releases are described under Contributing.

License

MIT. Developed by the NSF-Simons CosmicAI Institute.

Questions fréquentes

Qu'est-ce que MANNA ?

MCP server for IVOA astronomical archives: NOIRLab Astro Data Lab, NRAO/ALMA, CADC, ESO, Gaia

Comment installer MANNA ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add manna -e 'MANNA_ARCHIVES=<MANNA_ARCHIVES>' -e 'MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS>' -e 'MANNA_LOG_LEVEL=INFO' -e 'MANNA_INLINE_ROW_LIMIT=200' -- uvx manna-mcp==0.11.0 --stdio. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour MANNA ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

MANNA est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient MANNA ?

Il est publié par NSF-Simons-CosmicAI-Institute. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.