Astro MCP

Community

MCP server to support Astro project development

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #108 of 438
Stars: ★ 61 Popular
Transport: SSE
Runtime: Node.js
Credentials: No credential needed
License: MIT
Last commit: 8 months ago ⚠
Tools: 9

61FMRS · C

Astro MCP is an experimental MCP server designed to provide AI assistants with runtime information and documentation support for Astro projects. It is suitable for Astro developers but should be used with caution due to its experimental nature.

Strongest · Setup experience 14/20 Weakest · Reliability 9/20

Reliability

9/20

Security and permissions

11/20

Maintenance

14/20

Documentation

13/20

Setup experience

14/20

Why each score

Reliability 9/20: The server manifest and README describe a working SSE transport and multiple tools. Source code was not provided for review, but tool names and parameters in the description appear consistent. However, the project is marked experimental and unstable, with no visible tests or CI evidence, so per the static calibration the score is limited below 12. Deductions for lack of execution evidence, error handling, and edge cases.
Security and permissions 11/20: The README implies the server runs on localhost and exposes project information like config, routes, and integrations. No obvious red flags like malware, credential theft, or stealth exfiltration, but source code not available to verify data boundaries or potential unintended exposure. Score reflects insufficient evidence for full marks.
Maintenance 14/20: Repository is active with 59 stars and 13 open issues, but no commit history, release frequency, or dependency update information provided. MIT license is declared and maintainer identity appears genuine. Deductions for lack of visible governance and versioning details.
Documentation 13/20: README provides clear installation and usage instructions, including configuration examples for various editors/tools, and documents all tools with parameters. However, lacks troubleshooting, limitations, cost, and security considerations. Deductions for these missing documentation aspects.
Setup experience 14/20: Setup steps are straightforward: npx astro add astro-mcp or manual npm install and add integration to Astro config. The server automatically updates config files, but there is no explicit verification steps for mainstream clients or troubleshooting guidance. Since no execution evidence and relies on a local dev server, score below 15.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesUses the network

Best for

Developers using the Astro framework
Developers who want to enhance their AI coding assistant's understanding of their project

Not for

Projects not using Astro
Scenarios requiring a stable production server

Required permissions

Read Astro configuration files
Read project routing information
Access development server information
Access network to fetch documentation and integration data

Risks and side effects

Experimental package, may be unstable
May expose project configuration details
Depends on local development server, not available in production

Setup

Before you start

Runtime：Node.js

Run npx astro add astro-mcp in your Astro project directory, or manually install: npm install astro-mcp, then add the integration to your Astro config: integrations: [mcp()]. After installation, the MCP server will be available at http://localhost:4321/__mcp/sse.

.cursor/mcp.json

{
  "mcpServers": {
    "astro-mcp": {
      "url": "http://localhost:4321/__mcp/sse"
    }
  }
}

Shown for Cursor. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "astro-mcp": {
      "url": "http://localhost:4321/__mcp/sse"
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add --transport http astro-mcp http://localhost:4321/__mcp/sse

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After starting the Astro dev server, tools like get-astro-config should appear in your client's tool list; alternatively ask "What address is my Astro server on?" — an answer of http://localhost:4321 confirms the connection.

Troubleshooting

Ensure the Astro development server is running
Check if port 4321 is occupied
Verify that the MCP configuration file is created in the correct location

Things to try

Once connected, you can ask your AI assistant things like:

List all routes in my Astro project with their pre-rendering status
What address and port is my Astro dev server running on?
Search the Astro docs for how to use middleware
Show me details about the @astrojs/react integration

Tools 9

get-astro-config read-only

Get the Astro config object containing comprehensive project settings including file paths, site URL, build options, server settings, enabled integrations, markdown processing configuration, image handling, Vite plugins, security settings, and experimental features.

list-astro-routes read-only

List detailed routing information from your Astro project, including all routes with their file entrypoints, URL patterns, dynamic parameters, pre-rendering status, and route types. Optionally filter by type.

get-astro-server-address read-only

Get the current network address, IP protocol family, and port number of the running Astro development server.

list-astro-integrations read-only

List all Astro integrations available in the ecosystem.

get-astro-integration read-only

Get detailed metadata about a specific Astro integration, including its name, description, categories, repository links, npm information, related website links, official status, and download statistics.

search-astro-docs read-only

Search the Astro documentation for specific topics, concepts, or features. Returns relevant documentation snippets that match your query.

get-astro-changes read-only

Get the changelog of the Astro-related packages.

get-vite-config read-only

Get the Vite config digest, including the root, resolve, plugins, and environment names.

Show 1 more tools

get-vite-module-info read-only

Get graph information of a module, including importers, imported modules, and compiled result.

Use cases

Help AI assistants understand the configuration and routing structure of an Astro project.

Provide up-to-date Astro documentation search capability to aid development.

Get detailed information and changelogs for Astro integrations.

Supported clients

VS Code

Cursor

Windsurf

Claude Code

Listed from the project's documentation, not tested by this site.

Overview

Astro MCP server aims to help models understand your Astro project better by providing information that cannot be easily accessed just by looking at the project files, such as runtime information about the Astro server, up-to-date Astro docs content, and information about the Astro integrations you are using.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 413 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.7k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision ba9592f4d3cd Data synced 2026-10-19 Read the FMRS scoring method