Happy slice of mcp pizzaMCP.pizza

astro-mcp

MCP.Pizza Chef: morinokami

astro-mcp is an MCP server designed to enhance LLM understanding of Astro projects by exposing runtime server info, up-to-date documentation, and integration details. It enables models to access dynamic project context beyond static files, improving AI-driven development workflows within Astro environments. This experimental server integrates directly into Astro projects to provide real-time, structured context for AI agents.

Use This MCP server To

Provide LLMs with real-time Astro server runtime information Expose up-to-date Astro documentation content to models Share details about Astro integrations used in projects Enable AI agents to understand dynamic Astro project context Support AI-assisted coding and debugging in Astro projects Improve model accuracy by supplying non-file-based project data

README

astro-mcp

MCP server to support Astro project development, inspired by antfu's nuxt-mcp.

Important

This package is experimental and unstable. Proceed with caution when using it.

astro-mcp aims to help models understand your Astro project better, by providing them with 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
  • Information about the Astro integrations you are using

Installation

In your Astro project directory, run the following command:

npx astro add astro-mcp

Manual installation

First, install the astro-mcp package:

npm install astro-mcp

Then, add the astro-mcp integration to your Astro config:

import { defineConfig } from "astro/config";

import mcp from "astro-mcp";

export default defineConfig({
  integrations: [mcp()],
});

Usage

After installing the integration, the MCP server will be available at http://localhost:4321/__mcp/sse. You can use this URL to connect to the MCP server:

  • If you are using VSCode, create an empty .vscode/mcp.json file in the root of your project. astro-mcp will automatically update this file when the Astro server starts.
  • If you are using Cursor, create an empty .cursor/mcp.json file in the root of your project. astro-mcp will automatically update this file when the Astro server starts.

astro-mcp FAQ

How do I install astro-mcp in my Astro project?
Run 'npx astro add astro-mcp' in your project directory or install via npm and add it to your Astro config integrations.
Is astro-mcp stable for production use?
No, astro-mcp is currently experimental and unstable, so use it with caution.
What kind of information does astro-mcp provide to models?
It provides runtime server info, up-to-date Astro docs, and details about project integrations.
Can astro-mcp help with AI-assisted development?
Yes, by exposing dynamic project context, it enables better AI-driven coding and debugging workflows.
Does astro-mcp require configuration after installation?
Yes, you need to add the astro-mcp integration to your Astro config file.
Is astro-mcp compatible with other MCP clients and LLM providers?
Yes, it is designed to work with various MCP clients and supports models like OpenAI, Claude, and Gemini.
Where can I find more information or report issues?
Visit the astro-mcp GitHub repository for documentation and issue tracking.