aqc-mcp 2.0.1 → 2.1.1

package/README.md

@@ -6,7 +6,7 @@ A Model Context Protocol (MCP) server for astroquery-cli, providing HTTP and SSE
 
 ## Overview ✨
 
-The astroquery-mcp server exposes astroquery CLI functionality as MCP tools, allowing AI applications and other services to query astronomical databases through standardized MCP protocols. Supports both HTTP and SSE transports.
+The aqc-mcp server provides direct HTTP/TAP API access to 17+ astronomical databases as MCP tools, allowing AI applications and other services to query astronomical data through standardized MCP protocols. Supports both HTTP and SSE transports.
 
 ---
 
@@ -17,24 +17,54 @@ The astroquery-mcp server exposes astroquery CLI functionality as MCP tools, all
   - HTTP (default)
   - SSE (Server-Sent Events)
   - Stdio (for Claude Desktop)
-- 🔌 **Extensible**: Easy to add new tools and modules
-- 🌍 **Language Support**: Multi-language output (English, Chinese, Japanese)
+- 🔌 **17 Databases**: Direct TAP/REST API access to major astronomical archives
+- 🌍 **Language Support**: Multi-language output (English, Chinese)
 - 📊 **Rich Output**: Formatted tables and structured results
 - 🔑 **ADS API Token Support**: Environment variable injection for authenticated queries
+- ⚡ **No Python Required**: Pure Node.js/TypeScript implementation
 
 ---
 
 ## Supported Modules 🧩
 
-Currently implemented tools:
+Currently implemented tools (17 astronomical databases):
 
+### General Astronomy
 - **SIMBAD**: Query SIMBAD astronomical database
 - **VizieR**: Query VizieR catalog database
-- **ALMA**: Query ALMA observations archive
+- **NED**: NASA/IPAC Extragalactic Database
 - **ADS**: NASA Astrophysics Data System queries (requires API token)
-- **Gaia**: Gaia archive cone search
 
-> ⚠️ More modules (ESASky, IRSA, Heasarc, JPL, MAST, NED, NIST, Exoplanet, SDSS, ESO, Splatalogue) coming soon!
+### Radio & Millimeter
+- **ALMA**: Query ALMA observations archive
+- **ESO**: European Southern Observatory science archive
+
+### High Energy & X-ray
+- **Fermi LAT**: Fermi Large Area Telescope gamma-ray source catalog
+- **HEASARC**: High Energy Astrophysics Science Archive (multiple missions)
+
+### Infrared & Submillimeter
+- **IRSA**: NASA/IPAC Infrared Science Archive
+
+### Space Observatories
+- **MAST**: Barbara A. Mikulski Archive for Space Telescopes
+- **ESASky**: Multi-mission all-sky archive
+
+### Solar System
+- **JPL Horizons**: Solar system body ephemerides and state vectors
+- **JPL SBDB**: Small-Body Database for asteroids and comets
+
+### Exoplanets & Stars
+- **Exoplanet**: NASA Exoplanet Archive
+- **AAVSO**: Variable Star Index (VSX catalog)
+- **NIST**: Atomic Spectra Database for spectral lines
+
+### Optical Surveys
+- **Gaia**: Gaia DR3 catalog cone search and ADQL queries
+- **SDSS**: Sloan Digital Sky Survey (DR18)
+- **Splatalogue**: Spectral line database
+
+### Total: 17 databases, 30+ tools
 
 ---
 
@@ -43,13 +73,9 @@ Currently implemented tools:
 ### Quick Start
 
 **Prerequisites:**
-- Python ≥ 3.11
 - Node.js ≥ 18.0.0
 
-**Install Python CLI:**
-```bash
-pip install astroquery-cli
-```
+**No Python dependency required** - aqc-mcp uses direct HTTP/TAP APIs to astronomical services.
 
 ### MCP Server Configuration
 
@@ -355,18 +381,31 @@ npm run watch
 ### Project Structure
 
 ```
-astroquery-mcp/
+aqc-mcp/
 ├── src/
 │   ├── index.ts           # Main server entry
-│   ├── tools/             # MCP tool definitions
+│   ├── tools/             # MCP tool definitions (17 databases)
 │   │   ├── index.ts       # Tool registration
-│   │   ├── simbad.ts
-│   │   ├── vizier.ts
-│   │   ├── alma.ts
-│   │   ├── ads.ts
-│   │   └── gaia.ts
+│   │   ├── simbad.ts      # SIMBAD queries
+│   │   ├── vizier.ts      # VizieR catalog queries
+│   │   ├── alma.ts        # ALMA archive queries
+│   │   ├── ads.ts         # ADS bibliographic queries
+│   │   ├── gaia.ts        # Gaia DR3 queries
+│   │   ├── aavso.ts       # AAVSO VSX variable stars
+│   │   ├── fermi.ts       # Fermi LAT gamma-ray sources
+│   │   ├── heasarc.ts     # HEASARC queries
+│   │   ├── esasky.ts      # ESASky multi-mission archive
+│   │   ├── eso.ts         # ESO science archive
+│   │   ├── exoplanet.ts   # NASA Exoplanet Archive
+│   │   ├── irsa.ts        # IRSA infrared archive
+│   │   ├── jpl.ts         # JPL Horizons & SBDB
+│   │   ├── mast.ts        # MAST space telescopes
+│   │   ├── ned.ts         # NED extragalactic DB
+│   │   ├── nist.ts        # NIST atomic spectra
+│   │   ├── sdss.ts        # SDSS optical survey
+│   │   └── splatalogue.ts # Spectral line database
 │   └── utils/
-│       └── executor.ts    # CLI command executor
+│       └── http.ts        # HTTP/TAP client utilities
 ├── dist/                  # Compiled JavaScript
 ├── package.json
 └── tsconfig.json
@@ -386,10 +425,6 @@ astroquery-mcp/
 
 ## Troubleshooting 🔍
 
-### "aqc: command not found"
-
-Make sure you're running the MCP server from within the `astroquery-mcp` directory, and that the parent `astroquery-cli` project has been installed via poetry.
-
 ### ADS queries fail
 
 Set the `ADS_API_KEY` environment variable:
@@ -407,6 +442,10 @@ Change the port:
 PORT=8080 npm start
 ```
 
+### Query timeouts
+
+Some astronomical databases (e.g., Fermi LAT, HEASARC) may take longer to respond. The server uses reasonable timeout values, but you can adjust them if needed by modifying the `timeout` parameter in the HTTP client.
+
 ---
 
 ## License 📄
@@ -423,6 +462,6 @@ Contributions welcome! Please open an issue or PR.
 
 ## Links 🔗
 
-- [astroquery-cli](../README.md)
+- [GitHub Repository](https://github.com/inoribea/aqc-mcp)
 - [MCP Specification](https://modelcontextprotocol.io/)
 - [NASA ADS API](https://ui.adsabs.harvard.edu/)

package/dist/index.js

@@ -3,7 +3,9 @@ import { startSseAndStreamableHttpMcpServer } from 'mcp-http-server';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerAllTools } from './tools/index.js';
-const VERSION = '2.0.0';
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const VERSION = require('../package.json').version;
 function createMcpServer() {
     const server = new McpServer({ name: 'astroquery-mcp', version: VERSION }, { capabilities: { tools: {} } });
     registerAllTools(server);

package/dist/tools/aavso.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+const AAVSO_VSX_BASE = 'https://www.aavso.org/vsx/index.php';
+function parseVOTable(xmlText) {
+    const columns = [];
+    const rows = [];
+    const fieldRegex = /<FIELD\s+name="([^"]+)"/g;
+    let match;
+    while ((match = fieldRegex.exec(xmlText)) !== null) {
+        columns.push(match[1]);
+    }
+    const trRegex = /<TR>([\s\S]*?)<\/TR>/g;
+    let trMatch;
+    while ((trMatch = trRegex.exec(xmlText)) !== null) {
+        const tdRegex = /<TD>([\s\S]*?)<\/TD>/g;
+        const values = [];
+        let tdMatch;
+        while ((tdMatch = tdRegex.exec(trMatch[1])) !== null) {
+            values.push(tdMatch[1].trim());
+        }
+        const row = {};
+        columns.forEach((col, i) => {
+            row[col] = values[i] || null;
+        });
+        rows.push(row);
+    }
+    return { columns, rows };
+}
+function formatAavsoResult(data, title) {
+    const lines = [];
+    if (title)
+        lines.push(`## ${title}\n`);
+    if (data.rows.length === 0) {
+        lines.push('No results found.');
+        return lines.join('\n');
+    }
+    lines.push(`Found ${data.rows.length} result(s).\n`);
+    data.rows.forEach((row, idx) => {
+        if (data.rows.length > 1)
+            lines.push(`--- Result ${idx + 1} ---`);
+        for (const [key, value] of Object.entries(row)) {
+            if (value !== null && value !== undefined && value !== '' && value !== '\n') {
+                const cleanValue = String(value).replace(/<[^>]+>/g, '').trim();
+                if (cleanValue) {
+                    lines.push(`  ${key}: ${cleanValue}`);
+                }
+            }
+        }
+        lines.push('');
+    });
+    return lines.join('\n');
+}
+export function registerAavsoTools(server) {
+    server.tool('aavso_query_star', 'Query AAVSO VSX (Variable Star Index) for a specific variable star by name', {
+        star_name: z.string().describe('Variable star name or identifier (e.g., "Mira", "Delta Cephei", "SX Uma")'),
+        lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
+    }, async ({ star_name, lang }) => {
+        const url = `${AAVSO_VSX_BASE}?view=query.votable&ident=${encodeURIComponent(star_name)}`;
+        try {
+            const text = await (await fetch(url)).text();
+            const result = parseVOTable(text);
+            const title = lang === 'zh'
+                ? `AAVSO 变星查询: ${star_name}`
+                : `AAVSO Variable Star Query: ${star_name}`;
+            const output = formatAavsoResult(result, title);
+            return { content: [{ type: 'text', text: output }] };
+        }
+        catch (error) {
+            const errorMsg = lang === 'zh'
+                ? `查询失败: ${error instanceof Error ? error.message : String(error)}`
+                : `Query failed: ${error instanceof Error ? error.message : String(error)}`;
+            return { content: [{ type: 'text', text: errorMsg }] };
+        }
+    });
+    server.tool('aavso_query_region', 'Query AAVSO VSX for variable stars in a circular region around coordinates', {
+        ra: z.number().describe('Right Ascension in degrees (0-360)'),
+        dec: z.number().describe('Declination in degrees (-90 to 90)'),
+        radius: z.number().default(10).describe('Search radius in arcminutes'),
+        max_magnitude: z.number().optional().describe('Maximum magnitude filter (brighter than)'),
+        format: z.enum(['votable', 'json', 'xml']).default('votable').describe('Response format'),
+        lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
+    }, async ({ ra, dec, radius, max_magnitude, format, lang, }) => {
+        const params = new URLSearchParams({
+            view: 'api.list',
+            ra: String(ra),
+            dec: String(dec >= 0 ? `+${dec}` : dec),
+            radius: String(radius / 60),
+            format,
+        });
+        if (max_magnitude !== undefined) {
+            params.set('tomag', String(max_magnitude));
+        }
+        const url = `${AAVSO_VSX_BASE}?${params.toString()}`;
+        try {
+            const text = await (await fetch(url)).text();
+            let result;
+            if (format === 'json') {
+                const json = JSON.parse(text);
+                result = {
+                    columns: json.columns || [],
+                    rows: json.data || [],
+                };
+            }
+            else {
+                result = parseVOTable(text);
+            }
+            const title = lang === 'zh'
+                ? `AAVSO 区域查询: (${ra}, ${dec})`
+                : `AAVSO Regional Query: (${ra}, ${dec})`;
+            const output = formatAavsoResult(result, title);
+            return { content: [{ type: 'text', text: output }] };
+        }
+        catch (error) {
+            const errorMsg = lang === 'zh'
+                ? `查询失败: ${error instanceof Error ? error.message : String(error)}`
+                : `Query failed: ${error instanceof Error ? error.message : String(error)}`;
+            return { content: [{ type: 'text', text: errorMsg }] };
+        }
+    });
+}
+//# sourceMappingURL=aavso.js.map

package/dist/tools/esasky.js

@@ -1,24 +1,38 @@
 import { z } from 'zod';
 import { tapQuery, formatTapResult } from '../utils/http.js';
 const ESASKY_TAP = 'https://sky.esa.int/esasky-tap/tap/sync';
+const MISSION_TABLES = {
+    'xmm': 'observations.mv_v_v_xsa_esasky_photo_fdw_fdw',
+    'hst': 'observations.mv_v_v_hst_mmi_observation_fdw_fdw',
+    'alma': 'observations.mv_v_v_alma_obs_fdw',
+    'jwst': 'observations.mv_v_jwst_obs_fdw',
+    'chandra': 'observations.mv_chandra_obs_photo_fdw',
+    'herschel': 'observations.mv_v_v_hsa_esasky_photo_fdw_fdw',
+    'spitzer': 'observations.mv_spitzer_irac_fdw',
+    'suzaku': 'observations.mv_suzaku_data_fdw',
+    'cheops': 'observations.mv_cheops_obs_fdw',
+    'xmm-om': 'observations.mv_v_esasky_xmm_om_uv_fdw',
+    'iso': 'observations.mv_iso_spectra_fdw',
+    'iue': 'observations.mv_iue_spectra_fdw',
+    'akari': 'observations.mv_akari_irc_fdw',
+};
+const SUPPORTED_MISSIONS = Object.keys(MISSION_TABLES).join(', ');
 export function registerEsaskyTools(server) {
     server.tool('esasky_query', 'Query ESASky archive for astronomical observations by position and radius', {
         ra: z.number().describe('Right Ascension in degrees (0-360)'),
         dec: z.number().describe('Declination in degrees (-90 to 90)'),
         radius: z.number().default(10).describe('Search radius in arcminutes'),
-        mission: z.string().default('all').describe('Mission name (e.g. "XMM", "HST", "Herschel", "all")'),
+        mission: z.string().default('xmm').describe(`Mission name: ${SUPPORTED_MISSIONS}, or "all" for XMM default`),
         max_results: z.number().default(50).describe('Maximum number of results'),
         lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
     }, async ({ ra, dec, radius, mission, max_results, lang }) => {
+        const missionKey = mission.toLowerCase();
+        const tableName = MISSION_TABLES[missionKey] ?? MISSION_TABLES['xmm'];
         const radiusDeg = radius / 60;
-        let tableName = 'ivoa.obscore';
-        let missionFilter = '';
-        if (mission !== 'all') {
-            missionFilter = ` AND obs_collection = '${mission.replace(/'/g, "''")}'`;
-        }
-        const adql = `SELECT TOP ${max_results} obs_id, obs_collection, target_name, s_ra, s_dec, instrument_name, t_exptime, access_url FROM ${tableName} WHERE CONTAINS(POINT('ICRS', s_ra, s_dec), CIRCLE('ICRS', ${ra}, ${dec}, ${radiusDeg})) = 1${missionFilter}`;
-        const result = await tapQuery({ endpoint: ESASKY_TAP, adql, maxrec: max_results });
-        const title = lang === 'zh' ? `ESASky 查询结果: (${ra}, ${dec})` : `ESASky Query Result: (${ra}, ${dec})`;
+        const adql = `SELECT TOP ${max_results} observation_id, ra_deg, dec_deg, target_name, start_time, end_time FROM ${tableName} WHERE CONTAINS(POINT('ICRS', ra_deg, dec_deg), CIRCLE('ICRS', ${ra}, ${dec}, ${radiusDeg})) = 1`;
+        const result = await tapQuery({ endpoint: ESASKY_TAP, adql, format: 'csv', maxrec: max_results });
+        const resolvedMission = MISSION_TABLES[missionKey] ? missionKey.toUpperCase() : 'XMM';
+        const title = lang === 'zh' ? `ESASky 查询结果: (${ra}, ${dec}) [${resolvedMission}]` : `ESASky Query Result: (${ra}, ${dec}) [${resolvedMission}]`;
         return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
     });
 }

package/dist/tools/fermi.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { tapQuery, formatTapResult } from '../utils/http.js';
+const FERMI_TAP = 'https://fermi.gsfc.nasa.gov/ssc/data/access/lat/tap/sync';
+export function registerFermiTools(server) {
+    server.tool('fermi_lat_catalog_query', 'Query Fermi LAT point source catalog (4FGL-DR4, the latest 14-year catalog)', {
+        target: z.string().optional().describe('Target name (e.g., "Crab Nebula", "3C 273")'),
+        ra: z.number().optional().describe('Right Ascension in degrees (0-360)'),
+        dec: z.number().optional().describe('Declination in degrees (-90 to 90)'),
+        radius: z.number().default(5).describe('Search radius in degrees'),
+        min_energy: z.number().optional().describe('Minimum energy in MeV (e.g., 100)'),
+        max_energy: z.number().optional().describe('Maximum energy in MeV (e.g., 100000)'),
+        max_results: z.number().default(50).describe('Maximum number of results'),
+        lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
+    }, async ({ target, ra, dec, radius, min_energy, max_energy, max_results, lang, }) => {
+        if (!target && (ra === undefined || dec === undefined)) {
+            const msg = lang === 'zh' ? '请提供目标名称或坐标 (ra + dec)' : 'Please provide a target name or coordinates (ra + dec)';
+            return { content: [{ type: 'text', text: msg }] };
+        }
+        let where;
+        if (ra !== undefined && dec !== undefined) {
+            where = `CONTAINS(POINT('ICRS', ra, dec), CIRCLE('ICRS', ${ra}, ${dec}, ${radius})) = 1`;
+        }
+        else {
+            where = `source_name = '${target.replace(/'/g, "''")}'`;
+        }
+        let adql = `SELECT TOP ${max_results} source_name, ra, dec, glon, glat, flux_100mev, flux_1000mev, flux_10000mev, flux_100000mev, spectral_index, variability FROM fermilat.4fgl_dr4 WHERE ${where}`;
+        if (min_energy !== undefined || max_energy !== undefined) {
+            const energyFilter = [];
+            if (min_energy !== undefined)
+                energyFilter.push(`energy_gev >= ${min_energy / 1000}`);
+            if (max_energy !== undefined)
+                energyFilter.push(`energy_gev <= ${max_energy / 1000}`);
+            if (energyFilter.length > 0) {
+                adql = adql.replace(`WHERE ${where}`, `WHERE ${where} AND ${energyFilter.join(' AND ')}`);
+            }
+        }
+        try {
+            const result = await tapQuery({ endpoint: FERMI_TAP, adql, maxrec: max_results, timeout: 120000 });
+            const title = lang === 'zh'
+                ? `Fermi LAT 目录查询: ${target ?? `(${ra}, ${dec})`}`
+                : `Fermi LAT Catalog Query: ${target ?? `(${ra}, ${dec})`}`;
+            return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
+        }
+        catch (error) {
+            const errorMsg = lang === 'zh'
+                ? `查询失败: ${error instanceof Error ? error.message : String(error)}\n\n注意：Fermi LAT TAP 服务可能需要更长时间或暂时不可用。`
+                : `Query failed: ${error instanceof Error ? error.message : String(error)}\n\nNote: Fermi LAT TAP service may take longer or be temporarily unavailable.`;
+            return { content: [{ type: 'text', text: errorMsg }] };
+        }
+    });
+    server.tool('fermi_lat_adql', 'Execute a raw ADQL query on the Fermi LAT archive (TAP service)', {
+        adql: z.string().describe('ADQL query string'),
+        max_results: z.number().default(100).describe('Maximum number of results'),
+        lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
+    }, async ({ adql, max_results, lang }) => {
+        try {
+            const result = await tapQuery({ endpoint: FERMI_TAP, adql, maxrec: max_results, timeout: 120000 });
+            const title = lang === 'zh' ? 'Fermi LAT ADQL 查询结果' : 'Fermi LAT ADQL Query Result';
+            return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
+        }
+        catch (error) {
+            const errorMsg = lang === 'zh'
+                ? `查询失败: ${error instanceof Error ? error.message : String(error)}`
+                : `Query failed: ${error instanceof Error ? error.message : String(error)}`;
+            return { content: [{ type: 'text', text: errorMsg }] };
+        }
+    });
+}
+//# sourceMappingURL=fermi.js.map

package/dist/tools/heasarc.js

@@ -1,6 +1,20 @@
 import { z } from 'zod';
 import { tapQuery, formatTapResult } from '../utils/http.js';
 const HEASARC_TAP = 'https://heasarc.gsfc.nasa.gov/xamin/vo/tap/sync';
+const SIMBAD_TAP = 'https://simbad.cds.unistra.fr/simbad/sim-tap/sync';
+/**
+ * Resolve an object name to RA/Dec via SIMBAD TAP (supports JSON).
+ */
+async function resolveCoords(name) {
+    const safeName = name.replace(/'/g, "''");
+    const adql = `SELECT ra, dec FROM basic JOIN ident ON oidref = oid WHERE id = '${safeName}'`;
+    const result = await tapQuery({ endpoint: SIMBAD_TAP, adql, format: 'json' });
+    if (result.rows.length === 0) {
+        throw new Error(`Could not resolve object name: ${name}`);
+    }
+    const row = result.rows[0];
+    return { ra: Number(row.ra), dec: Number(row.dec) };
+}
 export function registerHeasarcTools(server) {
     server.tool('heasarc_query', 'Query HEASARC (High Energy Astrophysics Science Archive) by object name and mission catalog', {
         object_name: z.string().describe('Object name (e.g. "Crab Nebula", "Cyg X-1")'),
@@ -9,23 +23,14 @@ export function registerHeasarcTools(server) {
         max_results: z.number().default(50).describe('Maximum number of results'),
         lang: z.enum(['en', 'zh']).default('en').describe('Output language'),
     }, async ({ object_name, mission, radius, max_results, lang }) => {
-        // HEASARC TAP uses name resolver internally via a special function
-        // We query the mission table with a cone search around resolved coordinates
-        // First try a simple name-based query
+        // Step 1: Resolve object name to coordinates via SIMBAD
+        const coords = await resolveCoords(object_name);
+        // Step 2: Cone search on HEASARC with FORMAT=text (only format that works)
         const radiusDeg = radius / 60;
-        const adql = `SELECT TOP ${max_results} * FROM ${mission} WHERE CONTAINS(POINT('ICRS', ra, dec), CIRCLE('ICRS', COORD1(SIMBAD('${object_name.replace(/'/g, "''")}')), COORD2(SIMBAD('${object_name.replace(/'/g, "''")}')), ${radiusDeg})) = 1`;
-        try {
-            const result = await tapQuery({ endpoint: HEASARC_TAP, adql, maxrec: max_results });
-            const title = lang === 'zh' ? `HEASARC 查询结果: ${object_name} (${mission})` : `HEASARC Query Result: ${object_name} (${mission})`;
-            return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
-        }
-        catch {
-            // Fallback: some HEASARC tables use name column directly
-            const fallbackAdql = `SELECT TOP ${max_results} * FROM ${mission} WHERE name LIKE '%${object_name.replace(/'/g, "''").replace(/%/g, '')}%'`;
-            const result = await tapQuery({ endpoint: HEASARC_TAP, adql: fallbackAdql, maxrec: max_results });
-            const title = lang === 'zh' ? `HEASARC 查询结果: ${object_name} (${mission})` : `HEASARC Query Result: ${object_name} (${mission})`;
-            return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
-        }
+        const adql = `SELECT TOP ${max_results} * FROM ${mission} WHERE CONTAINS(POINT('ICRS', ra, dec), CIRCLE('ICRS', ${coords.ra}, ${coords.dec}, ${radiusDeg})) = 1`;
+        const result = await tapQuery({ endpoint: HEASARC_TAP, adql, format: 'text', maxrec: max_results });
+        const title = lang === 'zh' ? `HEASARC 查询结果: ${object_name} (${mission})` : `HEASARC Query Result: ${object_name} (${mission})`;
+        return { content: [{ type: 'text', text: formatTapResult(result, title) }] };
     });
 }
 //# sourceMappingURL=heasarc.js.map

package/dist/tools/index.js

@@ -3,6 +3,8 @@ import { registerVizierTools } from './vizier.js';
 import { registerAlmaTools } from './alma.js';
 import { registerGaiaTools } from './gaia.js';
 import { registerAdsTools } from './ads.js';
+import { registerAavsoTools } from './aavso.js';
+import { registerFermiTools } from './fermi.js';
 import { registerEsaskyTools } from './esasky.js';
 import { registerEsoTools } from './eso.js';
 import { registerExoplanetTools } from './exoplanet.js';
@@ -20,6 +22,8 @@ export function registerAllTools(server) {
     registerAlmaTools(server);
     registerGaiaTools(server);
     registerAdsTools(server);
+    registerAavsoTools(server);
+    registerFermiTools(server);
     registerEsaskyTools(server);
     registerEsoTools(server);
     registerExoplanetTools(server);

package/dist/tools/mast.js

@@ -1,14 +1,14 @@
 import { z } from 'zod';
 const MAST_API = 'https://mast.stsci.edu/api/v0/invoke';
 async function mastQuery(service, params, timeout = 60000) {
-    const body = JSON.stringify({ service, params, format: 'json', timeout: Math.floor(timeout / 1000) });
+    const requestPayload = JSON.stringify({ service, params, format: 'json', timeout: Math.floor(timeout / 1000) });
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeout);
     try {
         const response = await fetch(MAST_API, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body,
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: `request=${encodeURIComponent(requestPayload)}`,
             signal: controller.signal,
         });
         if (!response.ok) {

package/dist/utils/http.js

@@ -48,9 +48,41 @@ function parseTapResponse(text, format) {
     if (format === 'csv') {
         return parseCsvResponse(text);
     }
+    if (format === 'text') {
+        return parseTextResponse(text);
+    }
     // votable — return raw text as single-row result
     return { columns: ['votable'], rows: [{ votable: text }] };
 }
+/**
+ * Parse pipe-delimited text response from HEASARC TAP.
+ * Format: header row with | separators, data rows, footer with 'Number of rows/columns'.
+ */
+function parseTextResponse(text) {
+    const lines = text.split('\n').filter(line => {
+        const trimmed = line.trim();
+        return trimmed.length > 0 && !trimmed.startsWith('Number of');
+    });
+    if (lines.length === 0) {
+        return { columns: [], rows: [] };
+    }
+    const headers = lines[0].split('|').map(h => h.trim()).filter(h => h.length > 0);
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const values = lines[i].split('|').map(v => v.trim());
+        // Skip separator lines (e.g. '---+---+---')
+        if (values.every(v => /^[-+]+$/.test(v) || v.length === 0))
+            continue;
+        const obj = {};
+        for (let j = 0; j < headers.length; j++) {
+            const val = values[j + (values.length > headers.length ? 1 : 0)] ?? '';
+            const num = Number(val);
+            obj[headers[j]] = val.length > 0 && !isNaN(num) && val !== '' ? num : val;
+        }
+        rows.push(obj);
+    }
+    return { columns: headers, rows };
+}
 function parseJsonResponse(text) {
     const data = JSON.parse(text);
     // Standard TAP JSON response format (used by most TAP services)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aqc-mcp",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "description": "MCP server for astronomical database queries via direct HTTP/TAP APIs",
   "keywords": [
     "mcp",
@@ -12,7 +12,9 @@
     "vizier",
     "gaia",
     "alma",
-    "ads"
+    "ads",
+    "aavso",
+    "fermi"
   ],
   "homepage": "https://github.com/inoribea/aqc-mcp",
   "repository": {
@@ -29,17 +31,12 @@
   },
   "main": "dist/index.js",
   "type": "module",
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsc && node dist/index.js",
-    "watch": "tsc --watch"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "cors": "^2.8.5",
     "express": "^4.18.2",
-    "mcp-http-server": "^1.2.4"
+    "mcp-http-server": "^1.2.4",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/cors": "^2.8.17",
@@ -49,5 +46,11 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "watch": "tsc --watch"
   }
-}
+}

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC5C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IACF,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5D,IAAI,CAAC;QACH,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,MAAM,kCAAkC,CAAC;gBACvC,IAAI;gBACJ,IAAI,EAAE,IAAK;gBACX,kDAAkD;gBAClD,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,eAAe,EAAE;aAC/C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/tools/ads.d.ts

@@ -1,2 +0,0 @@
-export declare function registerAdsTools(server: any): void;
-//# sourceMappingURL=ads.d.ts.map

package/dist/tools/ads.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,QAkD3C"}

package/dist/tools/ads.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"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"}

package/dist/tools/alma.d.ts

@@ -1,2 +0,0 @@
-export declare function registerAlmaTools(server: any): void;
-//# sourceMappingURL=alma.d.ts.map

package/dist/tools/alma.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alma.d.ts","sourceRoot":"","sources":["../../src/tools/alma.ts"],"names":[],"mappings":"AAKA,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,QAiC5C"}

package/dist/tools/alma.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"alma.js","sourceRoot":"","sources":["../../src/tools/alma.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD,MAAM,UAAU,iBAAiB,CAAC,MAAW;IAC3C,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,mFAAmF,EACnF;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC7E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACxE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACzE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACrE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KACrE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAqG,EAAE,EAAE;QAC1J,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,wDAAwD,EAAE,CAAC,EAAE,CAAC;QAC5J,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,GAAG,EAAE,CAAC;QAC9B,IAAI,KAAa,CAAC;QAElB,IAAI,EAAE,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1C,KAAK,GAAG,uDAAuD,EAAE,KAAK,GAAG,KAAK,SAAS,QAAQ,CAAC;QAClG,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,kBAAkB,MAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,cAAc,WAAW,4HAA4H,KAAK,EAAE,CAAC;QAE1K,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,MAAM,IAAI,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,sBAAsB,MAAM,IAAI,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,CAAC;QAC5H,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/esasky.d.ts

@@ -1,2 +0,0 @@
-export declare function registerEsaskyTools(server: any): void;
-//# sourceMappingURL=esasky.d.ts.map

package/dist/tools/esasky.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"esasky.d.ts","sourceRoot":"","sources":["../../src/tools/esasky.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,QA4B9C"}