astro-mcp
@morinokami
MCP server to support Astro project development
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.
