Cloudscape MCP Assistant

基本能力

产品定位

Cloudscape MCP Assistant 是一个专门为 AWS Cloudscape Design System 设计的 MCP 服务器，旨在通过 Roo AI 助手提供组件发现、文档访问和代码生成等功能，提升开发效率。

核心功能

• 组件发现：通过直观搜索快速找到合适的 Cloudscape 组件
• 文档访问：直接在 Roo 中访问组件的全面文档
• 代码生成：为组件和常见模式生成样板代码
• 属性探索：理解组件属性及其关系
• 最佳实践：学习推荐的使用模式和实现方法

适用场景

• 开发者在 AWS Cloudscape Design System 中寻找合适的组件
• 需要快速生成组件代码的场景
• 学习和探索 Cloudscape 组件的最佳实践

工具列表

1. search_components：根据查询、类别和标签搜索 Cloudscape 组件
2. get_component_details：获取特定组件的详细信息
3. generate_component_code：为组件生成代码，包括属性、子元素和事件处理程序
4. generate_pattern_code：为常见 Cloudscape 模式生成代码
5. get_component_examples：获取组件的使用示例

常见问题解答

• 连接问题：确保使用 SSE 传输类型，并检查服务器名称和 URL
• CORS 设置：确保浏览器允许连接到服务器
• 服务器运行：通过测试脚本验证服务器是否正常运行

使用教程

使用依赖

• Node.js (v14 或更高版本)
• npm (v6 或更高版本)
• Roo AI 助手

安装教程

选项 1：从 npm 安装（推荐）

npm install -g @agentience/mcp-cloudscape-assistant

选项 2：从源代码安装

1. 克隆仓库：

git clone https://github.com/agentience/mcp-cloudscape-assistant.git
cd mcp-cloudscape-assistant

1. 安装依赖：

npm install

1. 构建包：

npm run build

1. 可选，全局链接包：

npm link

调试方式

1. 启动 MCP 服务器：

mcp-cloudscape-assistant

1. 验证服务器是否运行：检查终端消息确认服务器正在监听指定端口
2. 在 Roo 中连接 MCP 服务器：
3. 点击侧边栏的 MCP 图标
4. 点击“添加连接”
5. 输入名称和 URL（例如 http://localhost:3001）
6. 点击“连接”
7. 使用 Cloudscape Assistant 工具和资源进行对话

自动连接配置

mcp.json 示例

本地 MCP 服务器

{
  "connections": [
    {
      "name": "Cloudscape Assistant",
      "type": "stdio",
      "command": "mcp-cloudscape-assistant",
      "args": ["--port", "3000"],
      "env": {},
      "cwd": "${workspaceFolder}",
      "autoConnect": true
    }
  ]
}

远程 MCP 服务器

{
  "connections": [
    {
      "name": "Cloudscape Assistant",
      "type": "sse",
      "url": "http://remote-server-address:3001",
      "autoConnect": true
    }
  ]
}

许可证

该项目遵循 MIT 开源许可条款。