Astro Docs MCP Server

基本能力

产品定位

Astro Docs MCP Server 是一个专为AI代理提供Astro文档访问服务的MCP服务器。

核心功能

• 资源管理：通过astro-docs:// URI列出和访问Astro文档，每个文档部分都有标题、内容和类别。
• 工具：
• search_docs - 搜索Astro文档，接受搜索查询作为必需参数，返回匹配的文档部分。
• 提示：
• explain_astro_islands - 获取Astro Islands架构的详细解释。
• astro_project_setup - 新Astro项目的设置指南。
• astro_vs_other_frameworks - 比较Astro与其他Web框架。

适用场景

• AI代理帮助用户处理Astro相关任务时查找和引用Astro文档。
• 开发者在开发过程中快速获取Astro文档信息。

工具列表

• search_docs：搜索Astro文档的工具，返回匹配的文档部分。

常见问题解答

1. 路径问题：确保在配置中使用绝对路径，路径指向bin/astro-docs-mcp，构建目录存在且包含index.js，所有脚本都有可执行权限。
2. 模块未找到错误：确保已运行构建步骤，脚本从正确的目录运行，使用绝对路径执行脚本。
3. Node.js版本：确保使用Node.js v16或更高版本，推荐使用v20+。
4. 脚本权限：确保脚本具有可执行权限。
5. JSON输出问题：调试消息应发送到stderr，以避免混淆Claude Desktop。

使用教程

使用依赖

• Node.js v16或更高版本，推荐v20+。
• pnpm包管理器（优先于npm）。

安装教程

1. 安装依赖：

pnpm install

1. 构建服务器：

pnpm run build

1. 开发时自动重建：

pnpm run watch

运行服务器

pnpm start
# 或直接运行
./bin/astro-docs-mcp

调试方式

使用MCP Inspector进行调试：

pnpm run inspector

测试

测试客户端验证服务器功能：

pnpm test
# 或直接运行
node src/scripts/test-client.js

许可证

None