astro-mcp

Name: astro-mcp
Author: morinokami

本地服务

github.com/morinokami开发工具6136 周前更新

代码仓库

关于 astro-mcp

astro-mcp 是一个用于支持 Astro 项目开发的 MCP 服务，以集成（integration）形式安装。它向模型提供运行时服务器信息、最新 Astro 文档以及已用集成的详细信息。该项目目前为实验性质，并不稳定。

主要功能

01获取 Astro 配置与路由信息
02查询开发服务器地址
03搜索 Astro 文档
04查询 Astro 集成的元数据
05支持通过 mcp:setup 钩子扩展工具

适用场景

01让模型理解 Astro 项目的配置与路由结构
02在开发过程中查询 Astro 文档内容
03查看项目中已安装集成的详细信息

MCP 相关

该项目是一个 MCP 服务，在 Astro 开发服务器中提供 SSE 端点，向 MCP 客户端暴露项目配置、路由和文档等工具。

#mcp #astro #modelcontextprotocol

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y astro

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmastrostdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

astro-mcp

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

重要

此软件包处于实验阶段，尚不稳定。使用时请谨慎。

astro-mcp 旨在帮助模型更好地理解你的 Astro 项目，为其提供仅查看项目文件难以获取的信息，例如：

Astro 服务的运行时信息
最新的 Astro 文档内容
你正在使用的 Astro 集成信息

安装

在你的 Astro 项目目录中运行以下命令：

npx astro add astro-mcp

手动安装

首先，安装 astro-mcp 软件包：

npm install astro-mcp

然后，将 astro-mcp 集成添加到 Astro 配置中：

import { defineConfig } from "astro/config";

import mcp from "astro-mcp";

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

用法

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

编辑器/工具	配置文件
VSCode	`.vscode/mcp.json`
Cursor	`.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Claude Code	`.mcp.json`

Astro 服务启动时，astro-mcp 会自动更新该文件。

扩展 MCP 服务

astro-mcp 提供了一个名为 mcp:setup 的钩子，其他集成可以利用它来扩展 MCP 服务。如果你想向 MCP 服务添加自定义工具，这会很有用。

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) }],
        }));
      },
    },
  };
}

工具

get-astro-config：获取 Astro 配置对象，其中包含全面的项目设置，包括文件路径（root、src、public、output 目录）、网站 URL、构建选项、服务设置、已启用的集成、Markdown 处理配置、图像处理、Vite 插件、安全设置和实验性功能
- 参数：无
list-astro-routes：列出 Astro 项目的详细路由信息，包括所有路由的文件入口点、URL 模式、动态参数、预渲染状态和路由类型。还可按类型筛选，以便聚焦特定路由类别
- 参数：
  - type（字符串，可选）：redirect、page、endpoint 或 fallback
get-astro-server-address：获取正在运行的 Astro 开发服务的当前网络地址、IP 协议族和端口号
- 参数：无
list-astro-integrations：列出生态系统中所有可用的 Astro 集成
- 参数：无
get-astro-integration：获取特定 Astro 集成的详细元数据，包括其名称、描述、类别、仓库链接、npm 信息、相关网站链接、官方状态和下载统计数据
- 参数：
  - name（字符串）：要获取信息的 Astro 集成名称
search-astro-docs：搜索 Astro 文档中的特定主题、概念或功能。返回与你的查询相匹配的相关文档片段
- 参数：
  - query（字符串）：要搜索的查询
get-astro-changes：获取 Astro 相关软件包的变更日志
- 参数：
  - packageName（字符串）：要获取变更日志的 Astro 相关软件包名称

来自 `vite-plugin-mcp` 的工具

get-vite-config：获取 Vite 配置摘要，包括 root、resolve、plugins 和环境名称
- 参数：无
get-vite-module-info：获取模块的图信息，包括导入方、导入的模块和编译结果
- 参数：
  - filepath（字符串）：模块的绝对文件路径