适合谁
- 使用 Astro 框架进行开发的开发者
- 希望增强 AI 编码助手对项目理解的开发者
A
61FMRS · C
Astro MCP 是一个实验性的 MCP 服务器，旨在为 AI 助手提供 Astro 项目的运行时信息和文档支持。适合 Astro 开发者使用，但由于其实验性质，需谨慎使用。
Astro MCP 服务器旨在通过提供仅查看项目文件无法轻松获取的信息，帮助模型更好地理解您的 Astro 项目，包括 Astro 服务器的运行时信息、最新的 Astro 文档内容以及您正在使用的 Astro 集成信息。
工具能力
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 配置摘要，包括根目录、解析、插件和环境名称。
get-vite-module-info
获取模块的图信息，包括导入者、导入的模块和编译结果。
安装接入
在 Astro 项目目录中运行 npx astro add astro-mcp，或手动安装：npm install astro-mcp，然后在 Astro 配置中添加集成：integrations: [mcp()]。集成安装后，MCP 服务器将在 http://localhost:4321/__mcp/sse 上可用。
claude_desktop_config.json
{
"mcpServers": {
"astro-mcp": {
"url": "http://localhost:4321/__mcp/sse"
}
}
}
选型与风险
不适合谁
- 不使用 Astro 的项目
- 需要生产环境中稳定可靠服务器的场景
所需权限
- 读取 Astro 配置文件
- 读取项目路由信息
- 访问开发服务器信息
- 访问网络以获取文档和集成信息
风险与副作用
- 实验性包，可能不稳定
- 可能会暴露项目配置信息
- 依赖本地开发服务器，生产环境不可用
常见排障
- 确保 Astro 开发服务器正在运行
- 检查端口 4321 是否被占用
- 确认在正确的位置创建了 MCP 配置文件
使用场景
帮助 AI 助手理解 Astro 项目的配置和路由结构。
提供最新的 Astro 文档搜索能力，辅助开发。
获取 Astro 集成的详细信息和变更日志。
支持客户端
VSCode完整支持
Cursor完整支持
Windsurf完整支持
Claude Code完整支持