Peppi

Access planetary datasets from the Planetary Data System (PDS)

Prerequisites

• Python 3.13 or newer

User Quickstart

See https://nasa-pds.github.io/peppi/

Use as an MCP server with an LLM

Model Context Protocol (MCP) servers enable natural language–based tools (such as Claude Desktop) to interact with the PDS Registry through Peppi.

Two commands enable the connection of AI apps with Peppi using the Model Context Protocol (MCP) using the MCP stdio transport:

• pds-peppi-qb-mcp — a comprehensive MCP server that supports a wide range of query types for accessing PDS data.
• pds-peppi-mcp-server — a proof-of-concept MCP server that provides access to a limited subset of Peppi features (such as searches for instrument hosts and targets). It reuses the docstrings from Peppi methods, which reduces the integration overhead for each method.

Select one command and connect it to your LLM (such as Claude Desktop), for example, as described in these instructions; for example to connect pds-peppi-qb-mcp to Claude Desktop, use a configuration similar to the following:

    {
      "mcpServers": {
        "pds_peppi": {
          "command": "{whereever the package is installed}/bin/pds-peppi-qb-mcp",
          "args": []
         }
      }
    }

Once you've started Claude Desktop, you can enter requests like

• "Find Mars data"
• "Find calibrated Mars data"
• "Find Mercury data from the year 2020 only"
• Etc.

Code of Conduct

All users and developers of the NASA-PDS software are expected to abide by our Code of Conduct. Please read this to ensure you understand the expectations of our community.

Development

To develop this project, use your favorite text editor, or an integrated development environment with Python support, such as PyCharm.

Contributing

For information on how to contribute to NASA-PDS codebases please take a look at our Contributing guidelines.

Installation

Install in editable mode and with extra developer dependencies into your virtual environment of choice:

pip install git+https://github.com/NASA-AMMOS/slim-detect-secrets.git@exp
pip install --editable '.[dev]'

Then, configure the pre-commit hooks:

pre-commit install
pre-commit install -t pre-push
pre-commit install -t prepare-commit-msg
pre-commit install -t commit-msg

These hooks then will check for any future commits that might contain secrets. They also check code formatting, PEP8 compliance, type hints, etc.

👉 Note: A one time setup is required both to support detect-secerts and in your global Git configuration. See the wiki entry on Secrets to learn how.

Tests

This section describes testing for your package.

A complete "build" including test execution, linting (mypy, black, flake8, etc.), and documentation build is executed via:

tox

Build

pip install build
python3 -m build .

Publication

NASA PDS packages can publish automatically using the Roundup Action, which leverages GitHub Actions to perform automated continuous integration and continuous delivery. A default workflow that includes the Roundup is provided in the .github/workflows/unstable-cicd.yaml file. (Unstable here means an interim release.)

Manual Publication

Create the package:

python3 -m build .

Publish it as a Github release.

Publish on PyPI (you need a PyPI account and configure $HOME/.pypirc):

pip install twine
twine upload dist/*

Or publish on the Test PyPI (you need a Test PyPI account and configure $HOME/.pypirc):

pip install twine
twine upload --repository testpypi dist/*