aqc-mcp 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +48 -42
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -40,62 +40,68 @@ Currently implemented tools:
40
40
 
41
41
  ## Installation 🛠️
42
42
 
43
- ### Prerequisites
43
+ ### Quick Start
44
44
 
45
- - **Node.js** ≥ 18.0.0
46
- - **Python** ≥ 3.11
47
- - **astroquery-cli** installed via poetry in the parent directory
45
+ **Prerequisites:**
46
+ - Python ≥ 3.11
47
+ - Node.js ≥ 18.0.0
48
48
 
49
- ### Directory Structure
50
-
51
- ```
52
- astroquery-cli/ # Main CLI project (with poetry)
53
- ├── astroquery_cli/
54
- ├── pyproject.toml
55
- └── astroquery-mcp/ # This MCP server
56
- ├── src/
57
- └── package.json
49
+ **Install Python CLI:**
50
+ ```bash
51
+ pip install astroquery-cli
58
52
  ```
59
53
 
60
- ### Installation Steps
54
+ ### MCP Server Configuration
61
55
 
62
- 1. **Install astroquery-cli first** (in parent directory):
56
+ Add to your Claude Desktop config file:
63
57
 
64
- ```bash
65
- cd astroquery-cli
66
- poetry install
67
- poetry run aqc --help # Verify installation
68
- ```
58
+ **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
59
+ **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
69
60
 
70
- 2. **Install MCP dependencies**:
61
+ ```json
62
+ {
63
+ "mcpServers": {
64
+ "aqc-mcp": {
65
+ "command": "npx",
66
+ "args": ["-y", "aqc-mcp"],
67
+ "env": {
68
+ "ADS_API_KEY": "your-ads-api-token-here"
69
+ }
70
+ }
71
+ }
72
+ }
73
+ ```
71
74
 
72
- ```bash
73
- cd astroquery-mcp
74
- npm install
75
+ **Without ADS token:**
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "aqc-mcp": {
80
+ "command": "npx",
81
+ "args": ["-y", "aqc-mcp"]
82
+ }
83
+ }
84
+ }
75
85
  ```
76
86
 
77
- 3. **Build the MCP server**:
87
+ Get ADS token: https://ui.adsabs.harvard.edu/user/settings/token
88
+
89
+ ### Alternative: Global Install
78
90
 
79
91
  ```bash
80
- npm run build
92
+ npm install -g aqc-mcp
81
93
  ```
82
94
 
83
- 4. **Configure ADS API Token** (Optional but recommended for ADS queries):
84
-
85
- Get your token from: https://ui.adsabs.harvard.edu/user/settings/token
86
-
87
- Then set the environment variable:
88
-
89
- ```bash
90
- export ADS_API_KEY="your-ads-api-token-here"
91
- ```
92
-
93
- Or add to your shell profile (~/.bashrc, ~/.zshrc):
94
-
95
- ```bash
96
- echo 'export ADS_API_KEY="your-token"' >> ~/.bashrc
97
- source ~/.bashrc
98
- ```
95
+ Then use in config:
96
+ ```json
97
+ {
98
+ "mcpServers": {
99
+ "aqc-mcp": {
100
+ "command": "aqc-mcp"
101
+ }
102
+ }
103
+ }
104
+ ```
99
105
 
100
106
  ---
101
107
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aqc-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.2.0",
4
4
  "description": "MCP server for astroquery-cli with HTTP and SSE support",
5
5
  "keywords": ["mcp", "astroquery", "astronomy", "sse", "http", "simbad", "vizier", "gaia", "alma", "ads"],
6
6
  "homepage": "https://github.com/inoribea/aqc-mcp",