Dev astroMCP Installation

Overview

This guide walks you through installing and configuring the Dev astroMCP server for MCP-compatible clients like Cursor.

Prerequisites

| Software | Minimum Version | Check Command | Download | |----------|----------------|---------------|----------| | Node.js | 18.0.0 | node --version | nodejs.org | | npm | 9.0.0 | npm --version | Included with Node.js | | Cursor IDE | Latest | - | cursor.sh |

Get your API key

1. Sign in to your dashboard
2. Navigate to API Keys
3. Create a new API key and copy it immediately

IMPORTANT: The full API key is only shown once.

Installation methods

Choose one of the following:

One-line installer (experimental)

curl -sL https://raw.githubusercontent.com/MeridianMap/AstroMCP-Website/dev/scripts/install-mcp.sh \
  | ASTROMCP_API_KEY=astro_YOUR_KEY_HERE bash

Method A: Global npm install

npm install -g @astromcp-dev/mcp-server
meridian-mcp --version

Method B: npx (no install)

npx @astromcp-dev/mcp-server

Method C: Clone repository (development)

git clone https://github.com/MeridianMap/AstroMCP-Website.git
cd AstroMCP-Website/mcp-server
npm install
npm run build

Point your MCP host to: /path/to/AstroMCP-Website/mcp-server/dist/index.js

Cursor configuration

Cursor stores MCP server configuration in a JSON file:

| OS | Configuration Path | |----|-------------------| | macOS | ~/.cursor/mcp.json or ~/Library/Application Support/Cursor/User/globalStorage/mcp.json | | Windows | %APPDATA%\\Cursor\\User\\globalStorage\\mcp.json | | Linux | ~/.config/cursor/User/globalStorage/mcp.json |

If the file doesn't exist, create it. If unsure, check Cursor's Settings → MCP Servers for the actual path.

Add the configuration

For global npm install

{
  "mcpServers": {
    "astromcp-dev": {
      "command": "meridian-mcp",
      "args": [],
      "env": {
        "ASTROMCP_PROFILE": "dev",
        "ASTROMCP_BACKEND_URL": "https://api.astromcp.io",
        "ASTROMCP_API_KEY": "astro_YOUR_KEY_HERE"
      }
    }
  }
}

For npx

{
  "mcpServers": {
    "astromcp-dev": {
      "command": "npx",
      "args": ["@astromcp-dev/mcp-server"],
      "env": {
        "ASTROMCP_PROFILE": "dev",
        "ASTROMCP_BACKEND_URL": "https://api.astromcp.io",
        "ASTROMCP_API_KEY": "astro_YOUR_KEY_HERE"
      }
    }
  }
}

For local development

{
  "mcpServers": {
    "astromcp-dev": {
      "command": "node",
      "args": ["/absolute/path/to/AstroMCP-Website/mcp-server/dist/index.js"],
      "env": {
        "ASTROMCP_PROFILE": "dev",
        "ASTROMCP_BACKEND_URL": "http://localhost:8000",
        "ASTROMCP_API_KEY": "astro_YOUR_KEY_HERE"
      }
    }
  }
}

Verification

1. Restart Cursor completely (quit and reopen).
2. Open a Cursor chat and run:

Use dev.list_allowed to show me what endpoints I can call.

3. Make a test call:

Use dev.call to get the backend health status:
- method: GET
- path: /health

If this returns 200, you are connected.