Advertise
MCP.so
Sign In

Astro MCP Server

@morinokami

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

morinokami

About Astro MCP Server

MCP server to support Astro project development

#mcp#astro#modelcontextprotocol

Astro MCP Server config

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

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

Astro MCP Server tools

7

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

Frequently asked questions

1

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.

2

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.

3

What transports or authentication does astro-mcp use?

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

4

Which editors and tools are supported?

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

5

What are the known limits or stability?

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

Comments

More Other MCP servers

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise