English Français العربية

MANNA

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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"
            }
        }
    }
}

متغيرات البيئة

  • 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو MANNA؟

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

كيف أثبّت MANNA؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج MANNA إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل MANNA مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون MANNA؟

ينشره NSF-Simons-CosmicAI-Institute. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.