astro-mcp
by morinokami·★ 58·Score 43
MCP server providing Astro project insights, runtime info, documentation search, and integration data.
Overview
astro-mcp is an MCP server specifically designed to enhance AI model understanding of Astro projects by providing runtime information, access to up-to-date documentation, and data about installed integrations. It offers tools for retrieving Astro configurations, listing routes and integrations, searching documentation, and monitoring server status. The server integrates seamlessly with the Astro framework through its official integration system.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose this if you're working with Astro projects and want AI assistants to have better understanding of your project structure, configurations, and access to up-to-date documentation.
When NOT to choose this
Avoid using this in production as it's explicitly marked as experimental and unstable. Consider alternatives if you need a more mature solution.
Tools this server exposes
9 tools extracted from the READMEget-astro-configGet the Astro config object containing comprehensive project settings
list-astro-routesList detailed routing information from your Astro project
get-astro-server-addressGet the current network address and port of the running Astro development server
list-astro-integrationsList all Astro integrations available in the ecosystem
get-astro-integrationGet detailed metadata about a specific Astro integration
search-astro-docsSearch the Astro documentation for specific topics
get-astro-changesGet the changelog of Astro-related packages
get-vite-configGet the Vite configuration digest including root, resolve, plugins, and environment names
get-vite-module-infoGet graph information of a module including importers and imported modules
Comparable tools
Installation
npx astro add astro-mcpFor manual installation:
npm install astro-mcpThen add to your Astro config:
import { defineConfig } from "astro/config";
import mcp from "astro-mcp";
export default defineConfig({
integrations: [mcp()],
});The MCP server will be available at http://localhost:4321/__mcp/sse. Create an empty configuration file for your editor:
- VSCode:
.vscode/mcp.json - Cursor:
.cursor/mcp.json - Windsurf:
~/.codeium/windsurf/mcp_config.json - Claude Code:
.mcp.json
FAQ
- Is this MCP server production ready?
- The README explicitly states this package is 'experimental and unstable. Proceed with caution when using it.'
- Can I extend the MCP server with custom tools?
- Yes, astro-mcp provides a 'mcp:setup' hook that other integrations can use to add custom tools to the MCP server.
Compare astro-mcp with
Last updated · Auto-generated from public README + GitHub signals.