Add new NASA Earth imagery API and JPL tools for periodic orbits and scout

Author: ProgramComputer

package-lock.json

@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "",
-    "@modelcontextprotocol/sdk": "^1.7.0",
+    "@modelcontextprotocol/sdk": "^1.9.0",
     "axios": "",
     "cors": "",
     "dotenv": "",

package.json

@@ -0,0 +1,103 @@
+import axios from 'axios';
+import FormData from 'form-data'; // Need form-data for multipart POST
+import { addResource } from '../../index';
+
+/**
+ * Handler for JPL Horizons File API (POST request)
+ * 
+ * This API provides ephemeris data for solar system objects using a file-based input.
+ * It accepts the same parameters as the GET version but formats them for file submission.
+ * 
+ * @param args Request parameters (e.g., COMMAND, START_TIME, STOP_TIME, etc.)
+ * @returns API response
+ */
+export async function horizonsFileHandler(args: Record<string, any>) {
+  try {
+    // Base URL for the Horizons File API (POST)
+    const baseUrl = 'https://ssd.jpl.nasa.gov/api/horizons_file.api';
+    
+    // Format arguments into the key='value' text format for the input file
+    // DO NOT include format here, it's a separate form field.
+    const formattedArgs = { ...args };
+    delete formattedArgs.format; // Remove format if present
+
+    let fileContent = '!$$SOF\n'; // Add !SOF marker
+    for (const [key, value] of Object.entries(formattedArgs)) {
+      let formattedValue: string | number;
+      const upperKey = key.toUpperCase();
+
+      // Leave numbers unquoted
+      if (typeof value === 'number') {
+        formattedValue = value;
+      } 
+      // Quote ALL other values (strings, including YES/NO)
+      else {
+        formattedValue = `'${String(value).replace(/'/g, "\'")}'`;
+      }
+      
+      fileContent += `${upperKey}=${formattedValue}\n`;
+    }
+    fileContent += '!$$EOF\n'; // Correct !EOF marker
+
+    // Create FormData payload
+    const form = new FormData();
+    // Add format as a separate field
+    form.append('format', args.format || 'json'); 
+    // Add the file content under the 'input' field name
+    form.append('input', fileContent, {
+      filename: 'horizons_input.txt', // Required filename, content doesn't matter
+      contentType: 'text/plain',
+    });
+
+    // Make the API request using POST with multipart/form-data
+    const response = await axios.post(baseUrl, form, {
+      headers: {
+        ...form.getHeaders(), // Important for correct boundary
+      },
+    });
+    const data = response.data; // Assume response is JSON based on 'format=json'
+
+    // Create a resource URI that represents this query (similar to GET handler)
+    let resourceUri = 'jpl://horizons-file'; // Distinguish from GET
+    let resourceName = 'JPL Horizons file-based ephemeris data';
+
+    if (args.COMMAND) {
+      resourceUri += `/object/${encodeURIComponent(args.COMMAND)}`;
+      resourceName = `${args.COMMAND} ephemeris data (file input)`;
+      if (args.START_TIME && args.STOP_TIME) {
+        resourceName += ` (${args.START_TIME} to ${args.STOP_TIME})`;
+      }
+    }
+    
+    // Add response to resources
+    addResource(resourceUri, {
+      name: resourceName,
+      mimeType: "application/json", // Assuming JSON response
+      text: JSON.stringify(data, null, 2)
+    });
+    
+    // Format the response
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(data, null, 2)
+      }]
+    };
+  } catch (error: any) {
+    let errorMessage = `Error accessing JPL Horizons File API: ${error.message}`;
+    if (error.response) {
+      // Include more detail from the API response if available
+      errorMessage += `\nStatus: ${error.response.status}\nData: ${JSON.stringify(error.response.data)}`;
+    }
+    return {
+      content: [{
+        type: "text",
+        text: errorMessage
+      }],
+      isError: true
+    };
+  }
+}
+
+// Export default for dynamic imports in index.ts
+export default horizonsFileHandler; 

src/handlers/jpl/horizons_file.ts

@@ -0,0 +1,88 @@
+import axios from 'axios';
+import { addResource } from '../../index.js';
+
+// Define expected parameters based on documentation
+// Required: sys, family
+// Optional: libr, branch, periodmin, periodmax, periodunits, jacobimin, jacobimax, stabmin, stabmax
+interface PeriodicOrbitParams {
+  sys: string;
+  family: string;
+  libr?: number;
+  branch?: string;
+  periodmin?: number;
+  periodmax?: number;
+  periodunits?: string;
+  jacobimin?: number;
+  jacobimax?: number;
+  stabmin?: number;
+  stabmax?: number;
+}
+
+/**
+ * Handler for JPL Three-Body Periodic Orbits API
+ * 
+ * Fetches data on periodic orbits in specified three-body systems.
+ * 
+ * @param args Request parameters conforming to PeriodicOrbitParams
+ * @returns API response
+ */
+export async function periodicOrbitsHandler(args: PeriodicOrbitParams) {
+  try {
+    // Validate required parameters
+    if (!args.sys || !args.family) {
+      throw new Error('Missing required parameters: sys and family must be provided.');
+    }
+    
+    // Base URL for the Periodic Orbits API
+    const baseUrl = 'https://ssd-api.jpl.nasa.gov/periodic_orbits.api';
+    
+    // Make the API request using GET with parameters
+    const response = await axios.get(baseUrl, { params: args });
+    const data = response.data;
+    
+    // Create a resource URI 
+    // Example: jpl://periodic-orbits?sys=earth-moon&family=halo&libr=1&branch=N
+    let resourceUri = `jpl://periodic-orbits?sys=${encodeURIComponent(args.sys)}&family=${encodeURIComponent(args.family)}`;
+    let resourceName = `Periodic Orbits: ${args.sys} / ${args.family}`;
+    if (args.libr) {
+      resourceUri += `&libr=${args.libr}`;
+      resourceName += ` / L${args.libr}`;
+    }
+    if (args.branch) {
+      resourceUri += `&branch=${encodeURIComponent(args.branch)}`;
+      resourceName += ` / Branch ${args.branch}`;
+    }
+    // Potentially add filter params to URI/Name if needed for uniqueness
+
+    // Add response to resources
+    addResource(resourceUri, {
+      name: resourceName,
+      mimeType: "application/json", 
+      text: JSON.stringify(data, null, 2)
+    });
+    
+    // Format the response for MCP
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(data, null, 2)
+      }]
+    };
+  } catch (error: any) {
+    let errorMessage = `Error accessing JPL Periodic Orbits API: ${error.message}`;
+    if (error.response) {
+      // Include more detail from the API response if available
+      errorMessage += `\nStatus: ${error.response.status}\nData: ${JSON.stringify(error.response.data)}`;
+    }
+    return {
+      content: [{
+        type: "text",
+        text: errorMessage
+      }],
+      isError: true
+    };
+  }
+}
+
+// Export default for dynamic imports in index.ts
+export default periodicOrbitsHandler;