Skip to content
Back to search

mcp-server

Devstronomy MCP Server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/devstronomy--mcp-server/badge.svg)](/listings/devstronomy--mcp-server)

HTML

<a href="/listings/devstronomy--mcp-server"><img src="/api/listings/devstronomy--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 94 lines
  1. # Devstronomy MCP Server
  2. An MCP server for Solar System planets and their moons.
  3. As with the rest of [Devstronomy](https://github.com/devstronomy/), this project serves mainly for learning purposes - in this case, the [MCP](https://modelcontextprotocol.io).
  4. The data comes via [`devstronomy/nasa-data-scraper`](https://github.com/devstronomy/nasa-data-scraper) (see [`data/README.md`](data/README.md)).
  5. ## Feature Set
  6. | Kind | Name | Description |
  7. | ----------------- | ------------------------------ | ------------------------------------------------------------- |
  8. | Tool | `get_planet(name)` | One planet: structured data plus a text block with units |
  9. | Tool | `list_moons(planet)` | A planet's moons. A planet with no moons gives an empty list. |
  10. | Resource | `devstronomy://planets` | All planets as JSON |
  11. | Resource template | `devstronomy://planets/{name}` | One planet as JSON |
  12. | Prompt | `compare_planets(a, b)` | Asks the model to compare two planets using the tools above |
  13. Names are case-insensitive (`earth` = `Earth`). Pluto is included, as in the NASA fact sheet.
  14. ## Run
  15. Requires Node 24 (`nvm use`).
  16. ```sh
  17. npm install
  18. npm run dev
  19. npm run build && npm start
  20. ```
  21. The server listens on `http://127.0.0.1:3000/mcp`. Set `HOST` and `PORT` to change that. `GET /health` returns `{"status":"ok"}`.
  22. ## Connect a client
  23. **Claude Code:**
  24. ```sh
  25. claude mcp add --transport http devstronomy http://127.0.0.1:3000/mcp
  26. ```
  27. **MCP Inspector:**
  28. ```sh
  29. npx @modelcontextprotocol/inspector
  30. ```
  31. Choose the "Streamable HTTP" transport and enter `http://127.0.0.1:3000/mcp`.
  32. ## Raw JSON-RPC with curl
  33. This shows the protocol with nothing in between. Every MCP message is a JSON-RPC 2.0 request sent with `POST /mcp`.
  34. - Clients must send `Accept: application/json, text/event-stream`, even though this server only answers with JSON.
  35. - After `initialize`, send the negotiated version in the `MCP-Protocol-Version` header.
  36. **1. Initialize** (handshake: agree on the protocol version, exchange capabilities):
  37. ```sh
  38. curl -s http://127.0.0.1:3000/mcp \
  39. -H 'Content-Type: application/json' \
  40. -H 'Accept: application/json, text/event-stream' \
  41. -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
  42. ```
  43. **2. List tools:**
  44. ```sh
  45. curl -s http://127.0.0.1:3000/mcp \
  46. -H 'Content-Type: application/json' \
  47. -H 'Accept: application/json, text/event-stream' \
  48. -H 'MCP-Protocol-Version: 2025-11-25' \
  49. -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
  50. ```
  51. **3. Call a tool:**
  52. ```sh
  53. curl -s http://127.0.0.1:3000/mcp \
  54. -H 'Content-Type: application/json' \
  55. -H 'Accept: application/json, text/event-stream' \
  56. -H 'MCP-Protocol-Version: 2025-11-25' \
  57. -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_planet","arguments":{"name":"mars"}}}'
  58. ```
  59. ## Data notes
  60. - Units come from the [Planetary Fact Sheet notes](https://nssdc.gsfc.nasa.gov/planetary/factsheet/planetfact_notes.html) and the [JPL satellite page](https://ssd.jpl.nasa.gov/sats/phys_par/). They're defined once in `src/data.ts`, and appear in the tool descriptions and text output. Structured values are plain numbers.
  61. - Satellite `density` is in g/cm³, while planet `density` is in kg/m³.
  62. - Some values are `null`: `surfacePressure` for the gas giants, and a few satellite values the source marks as unknown.
  63. - `numberOfMoons` (e.g. Jupiter 79) can be larger than the number of moons `list_moons` returns (Jupiter 67). JPL lists only moons with known physical parameters, and the data is from 2019.
  64. ## License
  65. [MIT](LICENSE) for the code. The data is courtesy of NASA/NSSDCA and NASA/JPL-Caltech (see [`data/README.md`](data/README.md)).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.