astro-mcp

Name: astro-mcp
Author: morinokami

@morinokami

Repository

About astro-mcp

MCP server to support Astro project development

#mcp #astro #modelcontextprotocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "astro-mcp": {
      "command": "npx",
      "args": [
        "astro",
        "add",
        "astro-mcp"
      ]
    }
  }
}

Tools

Get the Astro config object containing comprehensive project settings including file paths (root, src, public, output directories), site URL, build options, server settings, enabled integrations, markdown processing configuration, image handling, Vite plugins, security settings, and experimental features

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 to focus on specific route categories

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

List all Astro integrations available in the ecosystem

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 the Astro documentation for specific topics, concepts, or features. Returns relevant documentation snippets that match your query

Get the changelog of the Astro-related packages

Overview

What is astro-mcp?

astro-mcp is an experimental MCP server that supports Astro project development by providing models with runtime information, up-to-date docs, and integration details that cannot be easily accessed from project files alone.

How to use astro-mcp?

Install via npx astro add astro-mcp or manually install the package and add the integration to your Astro config. The MCP server runs at http://localhost:4321/__mcp/sse and automatically updates editor configuration files (e.g., .vscode/mcp.json) when the Astro server starts.

Key features of astro-mcp

Provides runtime information about the Astro development server
Searches up-to-date Astro documentation for queries
Lists and retrieves metadata for Astro integrations
Retrieves Astro configuration and routing details
Exposes Vite config and module graph information via vite-plugin-mcp
Allows other integrations to extend the MCP server with custom tools

Use cases of astro-mcp

Assisting AI models in understanding an Astro project's configuration and routes
Providing documentation lookups for specific Astro concepts
Discovering available Astro integrations and their details
Checking the changelog of Astro-related packages
Debugging module dependencies in a Vite/Astro project

FAQ from astro-mcp

What makes astro-mcp different from just reading project files?

It provides runtime server address, up-to-date docs content, and integration information that static file analysis cannot capture.

How do I install astro-mcp?

Run npx astro add astro-mcp in your Astro project directory, or manually install the package and add the integration to your Astro config.

What transports or authentication does astro-mcp use?

It uses SSE at http://localhost:4321/__mcp/sse. No authentication is mentioned in the README.

Which editors and tools are supported?

VSCode, Cursor, Windsurf, and Claude Code through their respective MCP configuration files, which astro-mcp automatically updates.

What are the known limits or stability?

The package is marked as experimental and unstable. Proceed with caution.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K