aqc-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, inoribea
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,422 @@
+# Astroquery MCP Server 🚀
+
+A Model Context Protocol (MCP) server for astroquery-cli, providing HTTP and SSE (Server-Sent Events) transport options.
+
+---
+
+## 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.
+
+---
+
+## Features 🌟
+
+- ⚡ **MCP Protocol**: Full implementation of MCP specification
+- 🌐 **Multiple Transports**:
+  - 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)
+- 📊 **Rich Output**: Formatted tables and structured results
+- 🔑 **ADS API Token Support**: Environment variable injection for authenticated queries
+
+---
+
+## Supported Modules 🧩
+
+Currently implemented tools:
+
+- **SIMBAD**: Query SIMBAD astronomical database
+- **VizieR**: Query VizieR catalog database
+- **ALMA**: Query ALMA observations archive
+- **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!
+
+---
+
+## Installation 🛠️
+
+### Prerequisites
+
+- **Node.js** ≥ 18.0.0
+- **Python** ≥ 3.11
+- **astroquery-cli** installed via poetry in the parent directory
+
+### Directory Structure
+
+```
+astroquery-cli/          # Main CLI project (with poetry)
+├── astroquery_cli/
+├── pyproject.toml
+└── astroquery-mcp/      # This MCP server
+    ├── src/
+    └── package.json
+```
+
+### Installation Steps
+
+1. **Install astroquery-cli first** (in parent directory):
+
+```bash
+cd astroquery-cli
+poetry install
+poetry run aqc --help  # Verify installation
+```
+
+2. **Install MCP dependencies**:
+
+```bash
+cd astroquery-mcp
+npm install
+```
+
+3. **Build the MCP server**:
+
+```bash
+npm run build
+```
+
+4. **Configure ADS API Token** (Optional but recommended for ADS queries):
+
+   Get your token from: https://ui.adsabs.harvard.edu/user/settings/token
+   
+   Then set the environment variable:
+   
+   ```bash
+   export ADS_API_KEY="your-ads-api-token-here"
+   ```
+   
+   Or add to your shell profile (~/.bashrc, ~/.zshrc):
+   
+   ```bash
+   echo 'export ADS_API_KEY="your-token"' >> ~/.bashrc
+   source ~/.bashrc
+   ```
+
+---
+
+## Usage 🚀
+
+### 1. Start Server
+
+#### HTTP Mode (default)
+
+```bash
+npm start
+# or
+npm run dev
+```
+
+Server will start on `http://localhost:3000`
+
+#### With ADS API Token
+
+```bash
+ADS_API_KEY="your-token" npm start
+```
+
+#### Custom Port
+
+```bash
+PORT=8080 npm start
+```
+
+#### SSE Mode
+
+```bash
+MCP_TRANSPORT=http npm start
+```
+
+#### Stdio Mode (for Claude Desktop)
+
+```bash
+MCP_TRANSPORT=stdio npm run dev
+```
+
+---
+
+### 2. API Endpoints
+
+#### Health Check
+
+```bash
+curl http://localhost:3000/health
+```
+
+#### Server Info
+
+```bash
+curl http://localhost:3000/
+```
+
+#### SSE Connection
+
+```bash
+curl http://localhost:3000/sse
+```
+
+---
+
+## MCP Tools 🔧
+
+### simbad_query
+
+Query SIMBAD astronomical database.
+
+**Parameters:**
+- `object_name` (string, required): Object name (e.g., "M31", "NGC 1234")
+- `lang` (string, optional): Output language ("en", "zh", "ja")
+
+**Example:**
+
+```json
+{
+  "name": "simbad_query",
+  "arguments": {
+    "object_name": "M31",
+    "lang": "en"
+  }
+}
+```
+
+---
+
+### vizier_query
+
+Query VizieR catalog database.
+
+**Parameters:**
+- `target` (string, required): Target name or coordinates
+- `radius` (string, required): Search radius (e.g., "10arcsec", "0.5deg")
+- `catalog` (string, optional): Specific catalog name
+- `lang` (string, optional): Output language
+
+**Example:**
+
+```json
+{
+  "name": "vizier_query",
+  "arguments": {
+    "target": "M31",
+    "radius": "10arcsec",
+    "catalog": "I/345/gaia2"
+  }
+}
+```
+
+---
+
+### alma_query
+
+Query ALMA observations archive.
+
+**Parameters:**
+- `object_name` (string, required): Object name
+- `lang` (string, optional): Output language
+
+**Example:**
+
+```json
+{
+  "name": "alma_query",
+  "arguments": {
+    "object_name": "Orion KL"
+  }
+}
+```
+
+---
+
+### ads_query
+
+Query NASA Astrophysics Data System.
+
+**Parameters:**
+- `query` (string, optional): Search query string
+- `latest` (boolean, optional): Get latest papers
+- `review` (boolean, optional): Get review articles only
+- `lang` (string, optional): Output language
+
+**Requirements:**
+- Set `ADS_API_KEY` environment variable before starting the server
+
+**Example:**
+
+```json
+{
+  "name": "ads_query",
+  "arguments": {
+    "latest": true,
+    "lang": "en"
+  }
+}
+```
+
+---
+
+### gaia_cone_search
+
+Query Gaia archive via cone search.
+
+**Parameters:**
+- `target` (string, required): Target name or coordinates
+- `radius` (string, optional): Search radius (default: "10arcsec")
+- `lang` (string, optional): Output language
+
+**Example:**
+
+```json
+{
+  "name": "gaia_cone_search",
+  "arguments": {
+    "target": "M31",
+    "radius": "1arcmin"
+  }
+}
+```
+
+---
+
+## HTTP API Examples 📡
+
+### Call a Single Tool
+
+```bash
+curl -X POST http://localhost:3000/tools/call \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "simbad_query",
+    "arguments": {
+      "object_name": "M31"
+    }
+  }'
+```
+
+### Batch Call Multiple Tools
+
+```bash
+curl -X POST http://localhost:3000/tools/batch \
+  -H "Content-Type: application/json" \
+  -d '{
+    "tools": [
+      {
+        "name": "simbad_query",
+        "arguments": {"object_name": "M31"}
+      },
+      {
+        "name": "gaia_cone_search",
+        "arguments": {"target": "M31", "radius": "10arcsec"}
+      }
+    ]
+  }'
+```
+
+---
+
+## Claude Desktop Integration 🖥️
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "astroquery": {
+      "command": "node",
+      "args": ["/path/to/astroquery-cli/astroquery-mcp/dist/index.js"],
+      "env": {
+        "MCP_TRANSPORT": "stdio",
+        "ADS_API_KEY": "your-ads-api-token-here"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Development 🔨
+
+### Watch Mode
+
+```bash
+npm run watch
+```
+
+### Project Structure
+
+```
+astroquery-mcp/
+├── src/
+│   ├── index.ts           # Main server entry
+│   ├── tools/             # MCP tool definitions
+│   │   ├── index.ts       # Tool registration
+│   │   ├── simbad.ts
+│   │   ├── vizier.ts
+│   │   ├── alma.ts
+│   │   ├── ads.ts
+│   │   └── gaia.ts
+│   └── utils/
+│       └── executor.ts    # CLI command executor
+├── dist/                  # Compiled JavaScript
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Environment Variables 🔧
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `MCP_TRANSPORT` | Transport mode (`http`, `stdio`) | `stdio` | No |
+| `PORT` | HTTP server port | `3000` | No |
+| `ADS_API_KEY` | NASA ADS API token | - | For ADS queries |
+
+---
+
+## 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:
+
+```bash
+export ADS_API_KEY="your-token"
+npm start
+```
+
+### Port already in use
+
+Change the port:
+
+```bash
+PORT=8080 npm start
+```
+
+---
+
+## License 📄
+
+BSD-3-Clause
+
+---
+
+## Contributing 🤝
+
+Contributions welcome! Please open an issue or PR.
+
+---
+
+## Links 🔗
+
+- [astroquery-cli](../README.md)
+- [MCP Specification](https://modelcontextprotocol.io/)
+- [NASA ADS API](https://ui.adsabs.harvard.edu/)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,182 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { executeAqc } from './utils/executor.js';
+import { listTools } from './tools/index.js';
+const PORT = process.env.PORT ? parseInt(process.env.PORT) : 3000;
+async function createMcpServer() {
+    const server = new McpServer({
+        name: 'astroquery-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    await listTools(server);
+    return server;
+}
+// Helper function to build command arguments
+function buildArgs(module, command, mainArg, extraArgs) {
+    const args = [module, command, mainArg];
+    for (const arg of extraArgs) {
+        if (arg)
+            args.push(arg);
+    }
+    return args;
+}
+async function startHttpServer() {
+    const express = (await import('express')).default;
+    const cors = (await import('cors')).default;
+    const app = express();
+    app.use(cors());
+    app.use(express.json());
+    const mcpServer = await createMcpServer();
+    // GET /health - Health check
+    app.get('/health', (req, res) => {
+        res.json({ status: 'ok' });
+    });
+    // GET / - Server info
+    app.get('/', (req, res) => {
+        res.json({
+            name: 'astroquery-mcp',
+            version: '1.0.0',
+            protocol: 'MCP',
+            transport: 'HTTP',
+            endpoints: {
+                health: '/health',
+                sse: '/sse',
+                tools: '/tools'
+            }
+        });
+    });
+    // GET /sse - SSE endpoint
+    app.get('/sse', async (req, res) => {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.write(`data: ${JSON.stringify({ type: 'connected' })}\n\n`);
+        req.on('close', () => {
+            res.end();
+        });
+    });
+    // POST /tools/list - List available tools
+    app.get('/tools/list', (req, res) => {
+        res.json({ message: 'Use MCP protocol to list tools' });
+    });
+    // POST /tools/call - Call a tool directly (for HTTP clients)
+    app.post('/tools/call', async (req, res) => {
+        try {
+            const { name, arguments: args } = req.body;
+            if (!name) {
+                return res.status(400).json({ error: 'Tool name is required' });
+            }
+            const cmdArgs = [];
+            switch (name) {
+                case 'simbad_query':
+                    cmdArgs.push('simbad', 'object', args.object_name);
+                    break;
+                case 'vizier_query':
+                    cmdArgs.push('vizier', 'object', args.target, args.radius);
+                    if (args.catalog)
+                        cmdArgs.push('--catalog', args.catalog);
+                    break;
+                case 'alma_query':
+                    cmdArgs.push('alma', 'object', args.object_name);
+                    break;
+                case 'ads_query':
+                    cmdArgs.push('ads', 'query');
+                    if (args.latest)
+                        cmdArgs.push('--latest');
+                    if (args.review)
+                        cmdArgs.push('--review');
+                    if (args.query)
+                        cmdArgs.push(args.query);
+                    break;
+                case 'gaia_cone_search':
+                    cmdArgs.push('gaia', 'cone-search', args.target);
+                    if (args.radius)
+                        cmdArgs.push('--radius', args.radius);
+                    break;
+                default:
+                    throw new Error(`Tool '${name}' not found`);
+            }
+            const result = await executeAqc(cmdArgs);
+            res.json({ content: [{ type: 'text', text: result.output || '' }] });
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    // POST /tools/batch - Call multiple tools in parallel
+    app.post('/tools/batch', async (req, res) => {
+        try {
+            const { tools } = req.body;
+            if (!Array.isArray(tools)) {
+                return res.status(400).json({ error: 'Tools must be an array' });
+            }
+            const results = await Promise.all(tools.map(async ({ name, arguments: args }) => {
+                try {
+                    const cmdArgs = [];
+                    switch (name) {
+                        case 'simbad_query':
+                            cmdArgs.push('simbad', 'object', args.object_name);
+                            break;
+                        case 'vizier_query':
+                            cmdArgs.push('vizier', 'object', args.target, args.radius);
+                            if (args.catalog)
+                                cmdArgs.push('--catalog', args.catalog);
+                            break;
+                        case 'alma_query':
+                            cmdArgs.push('alma', 'object', args.object_name);
+                            break;
+                        case 'ads_query':
+                            cmdArgs.push('ads', 'query');
+                            if (args.latest)
+                                cmdArgs.push('--latest');
+                            if (args.review)
+                                cmdArgs.push('--review');
+                            if (args.query)
+                                cmdArgs.push(args.query);
+                            break;
+                        case 'gaia_cone_search':
+                            cmdArgs.push('gaia', 'cone-search', args.target);
+                            if (args.radius)
+                                cmdArgs.push('--radius', args.radius);
+                            break;
+                        default:
+                            throw new Error(`Tool '${name}' not found`);
+                    }
+                    const result = await executeAqc(cmdArgs);
+                    return { name, success: true, result: { content: [{ type: 'text', text: result.output || '' }] } };
+                }
+                catch (error) {
+                    return { name, success: false, error: error.message };
+                }
+            }));
+            res.json(results);
+        }
+        catch (error) {
+            res.status(500).json({ error: error.message });
+        }
+    });
+    app.listen(PORT, () => {
+        console.log(`Astroquery MCP Server running on http://localhost:${PORT}`);
+        console.log(`Health check: http://localhost:${PORT}/health`);
+        console.log(`Tools list: http://localhost:${PORT}/tools/list`);
+        console.log(`SSE endpoint: http://localhost:${PORT}/sse`);
+    });
+}
+async function startStdioServer() {
+    const server = await createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Start server based on transport mode
+const mode = process.env.MCP_TRANSPORT || 'stdio';
+if (mode === 'http') {
+    startHttpServer();
+}
+else {
+    startStdioServer();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/ads.d.ts

@@ -0,0 +1,4 @@
+declare let executeAdsQuery: (query?: string, lang?: string) => Promise<string>;
+export declare function registerAdsTools(server: any): void;
+export { executeAdsQuery };
+//# sourceMappingURL=ads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"AAGA,QAAA,IAAI,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,QAiC3C;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/tools/ads.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { executeAqc } from '../utils/executor.js';
+let executeAdsQuery;
+export function registerAdsTools(server) {
+    executeAdsQuery = async (query, lang) => {
+        const args = ['ads', 'query'];
+        if (query)
+            args.push('--query', query);
+        if (lang)
+            args.push('--lang', lang);
+        const result = await executeAqc(args);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        return result.output || '';
+    };
+    server.tool('ads_query', 'Query NASA Astrophysics Data System for papers and bibliographic information', {
+        query: z.string().optional().describe('Search query (e.g., "latest papers", "highly cited reviews")'),
+        lang: z.enum(['en', 'zh']).optional().describe('Output language'),
+    }, async ({ query, lang }) => {
+        const output = await executeAdsQuery(query, lang);
+        return {
+            content: [{
+                    type: 'text',
+                    text: output
+                }]
+        };
+    });
+}
+export { executeAdsQuery };
+//# sourceMappingURL=ads.js.map

package/dist/tools/ads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads.js","sourceRoot":"","sources":["../../src/tools/ads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,IAAI,eAAmE,CAAC;AAExE,MAAM,UAAU,gBAAgB,CAAC,MAAW;IAC1C,eAAe,GAAG,KAAK,EAAE,KAAc,EAAE,IAAa,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,8EAA8E,EAC9E;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;QACrG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;KAClE,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}