← 返回目录

Astro MCP

社区

用于 Astro 项目开发的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 108 / 438
Stars: ★ 61 热门
传输方式: SSE
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 8 个月前 ⚠
工具数: 9

61FMRS · C

Astro MCP 是一个实验性的 MCP 服务器，旨在为 AI 助手提供 Astro 项目的运行时信息和文档支持。适合 Astro 开发者使用，但由于其实验性质，需谨慎使用。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

14/20

文档质量

13/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: 服务器清单和README描述了一个SSE传输，并声明了多个工具。源代码（未提供）未被审查，但描述中的工具名称和参数一致。然而，项目标记为实验性且不稳定，没有可见的测试或CI证据，因此根据静态校准，可靠性得分限制在12以下。扣除是因为缺少执行证据、错误处理和边缘情况不明确。
安全与权限 11/20: README暗示服务器在本地主机上运行，并公开项目信息，如配置、路由和集成。未发现明显的恶意行为、凭据盗窃或数据外泄迹象，但未提供源代码来验证是否存在意外数据披露或权限提升。由于无法检查源代码，安全性得分较低。
维护活跃度 14/20: 仓库活跃，有59星和13个未关闭问题，但未提供提交历史、发布频率或依赖更新信息。已声明MIT许可证，维护者身份看起来真实。扣除是因为没有可见的持续维护治理和版本管理细节。
文档质量 13/20: README提供了清晰的安装和使用说明，包括不同编辑器/工具的配置示例，并记录了所有工具及其参数。然而，文档缺乏故障排除、限制、成本或安全注意事项。扣除是因为这些缺失的文档方面。
安装易用性 14/20: 安装步骤简单，包括npx astro add astro-mcp或手动npm安装，并添加集成到Astro配置中。服务器会自动更新配置文件，但缺少对主流客户端的明确验证步骤和故障排除指导。由于没有执行验证，且依赖本地开发服务器，得分低于15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

使用 Astro 框架进行开发的开发者
希望增强 AI 编码助手对项目理解的开发者

不适合谁

不使用 Astro 的项目
需要生产环境中稳定可靠服务器的场景

所需权限

读取 Astro 配置文件
读取项目路由信息
访问开发服务器信息
访问网络以获取文档和集成信息

风险与副作用

实验性包，可能不稳定
可能会暴露项目配置信息
依赖本地开发服务器，生产环境不可用

安装接入

准备工作

运行环境：Node.js

在 Astro 项目目录中运行 npx astro add astro-mcp，或手动安装：npm install astro-mcp，然后在 Astro 配置中添加集成：integrations: [mcp()]。集成安装后，MCP 服务器将在 http://localhost:4321/__mcp/sse 上可用。

.cursor/mcp.json

{
  "mcpServers": {
    "astro-mcp": {
      "url": "http://localhost:4321/__mcp/sse"
    }
  }
}

以 Cursor 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "astro-mcp": {
      "url": "http://localhost:4321/__mcp/sse"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http astro-mcp http://localhost:4321/__mcp/sse

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动 Astro 开发服务器后，在客户端工具列表中应能看到 get-astro-config 等工具；也可以直接提问“我的 Astro 服务器地址是多少”，如果回答为 http://localhost:4321 则连接成功。

常见排障

确保 Astro 开发服务器正在运行
检查端口 4321 是否被占用
确认在正确的位置创建了 MCP 配置文件

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 Astro 项目中的所有路由及其预渲染状态
我的 Astro 开发服务器运行在哪个地址和端口？
在 Astro 文档中搜索关于 middleware 的用法
查看 @astrojs/react 这个集成的详细信息

工具能力 9

get-astro-config 只读

获取 Astro 配置对象，包含全面的项目设置，如文件路径、站点 URL、构建选项、服务器设置、启用的集成、Markdown 处理配置、图像处理、Vite 插件、安全设置和实验性功能。

list-astro-routes 只读

列出 Astro 项目的详细路由信息，包括所有路由的文件入口点、URL 模式、动态参数、预渲染状态和路由类型。可选按类型过滤。

get-astro-server-address 只读

获取当前运行的 Astro 开发服务器的网络地址、IP 协议族和端口号。

list-astro-integrations 只读

列出生态系统中所有可用的 Astro 集成。

get-astro-integration 只读

获取特定 Astro 集成的详细元数据，包括名称、描述、类别、仓库链接、npm 信息、相关网站链接、官方状态和下载统计。

search-astro-docs 只读

搜索 Astro 文档，查找特定主题、概念或功能。返回匹配查询的相关文档片段。

get-astro-changes 只读

获取 Astro 相关包的变更日志。

get-vite-config 只读

获取 Vite 配置摘要，包括根目录、解析、插件和环境名称。

展开其余 1 个工具

get-vite-module-info 只读

获取模块的图信息，包括导入者、导入的模块和编译结果。

使用场景

帮助 AI 助手理解 Astro 项目的配置和路由结构。

提供最新的 Astro 文档搜索能力，辅助开发。

获取 Astro 集成的详细信息和变更日志。

支持客户端

VS Code

Cursor

Windsurf

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Astro MCP 服务器旨在通过提供仅查看项目文件无法轻松获取的信息，帮助模型更好地理解您的 Astro 项目，包括 Astro 服务器的运行时信息、最新的 Astro 文档内容以及您正在使用的 Astro 集成信息。