MCP服务器支持Astro项目开发，灵感来自antfu的nuxt-mcp。

[!重要] 此包装处于实验阶段且不稳定。使用时请谨慎使用。

astro-mcp 旨在帮助模型更好地理解你的天文项目，通过提供仅凭项目文件无法轻松获取的信息，例如：

• 关于Astro服务器的运行时信息
• 最新的天文文档内容
• 关于您所使用的Astro集成的信息

安装

在您的 Astro 项目目录中，执行以下命令：

手动安装

首先，安装 astro-mcp 包：

然后，在你的Astro配置中添加astro-mcp集成：

用途

安装集成后，MCP 服务器将在 [http://localhost:4321/__mcp/sse. 提供连接。连接时，请在编辑器或工具的适当位置创建一个空配置文件：

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. To connect, create an empty configuration file in the appropriate location for your editor or tool:

astro-mcp will automatically update the file when the Astro server starts.

Extending the MCP server

astro-mcp provides a hook called mcp:setup that other integrations can use to extend the MCP server. This is useful if you want to add custom tools to the MCP server.

export default function createExampleIntegration(): AstroIntegration {
  return {
    name: "example-integration",
    hooks: {
      "mcp:setup": async ({ mcp }) => {
        mcp.tool("add", { a: z.number(), b: z.number() }, async ({ a, b }) => ({
          content: [{ type: "text", text: String(a + b) }],
        }));
      },
    },
  };
}

Tools

• get-astro-config: 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
  • Parameters: None
• list-astro-routes: 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
  • Parameters:
    • type (string, optional): redirect, page, endpoint, or fallback