Cloudscape Docs MCP Server

Cloudscape文档MCP服务器

通过AWS提供语义搜索的模型上下文协议（MCP）服务器 Cloudscape设计 系统文档。专为AI代理和编码助手构建，可高效查询组件文档。

特性

• 语义搜索 -使用由提供支持的自然语言查询查找相关文档 阿里巴巴GTE多语种基地 模型
• 代币高效 -首先返回简洁的文件列表，按需返回完整内容
• 硬件优化 -自动检测苹果硅（MPS）、CUDA或CPU
• 本地矢量存储 -使用LanceDB进行快速的基于文件的矢量搜索

运输

此服务器使用MCP stdio传输 协议。\ 可流式HTTP传输 马上就来。

工具

Cloudscape Docs MCP Tools in Action

______________________________________________________________________

需求

• Python 3.13+
• 约3GB磁盘空间用于嵌入模型
• 建议使用8GB+RAM

安装

# Clone the repository
git clone https://github.com/praveenc/cloudscape-docs-mcp.git
cd cloudscape-docs-mcp

# Create virtual environment and install dependencies
uv sync

# Or with pip
pip install -e .

设置

1.添加文档

将Cloudscape文档文件放在 docs/ 目录。支持的格式：

• .md （Markdown）
• .txt （纯文本）
• .tsx / .ts （Types/React）

2.建立指数

运行摄取脚本以创建向量数据库：

uv run ingest.py

这将：

• 扫描中的所有文件 docs/
• 将内容分为约2000个字符段
• 使用生成嵌入 阿里巴巴GTE多语种基地 嵌入模型
• 将矢量存储在 data/lancedb/

注： 跑步 uv run ingest.py 多次是安全的，但执行 完全重新索引 每次。脚本使用 mode="overwrite" 它删除并重新创建数据库表。没有增量更新或更改检测——每次运行时都会重新扫描并重新嵌入所有文档。这是幂等的（相同的文档产生相同的结果），但对于大型文档集来说计算成本很高。

3.运行服务器

uv run server.py

MCP客户端配置

克劳德桌面版

添加到您的 mcp.json:

{
  "mcpServers": {
    "cloudscape-docs": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/cloudscape-docs-mcp", "python", "server.py"]
    }
  }
}

光标/VS代码/风帆/基洛

添加到MCP设置中：

{
  "cloudscape-docs": {
    "command": "uv",
    "args": ["run", "--directory", "/path/to/cloudscape-docs-mcp", "python", "server.py"]
  }
}

泽德

添加到Zed设置(settings.json):

{
  "context_servers": {
    "cloudscape-docs": {
      "command": {
        "path": "uv",
        "args": ["run", "--directory", "/path/to/cloudscape-docs-mcp", "python", "server.py"]
      }
    }
  }
}

用法示例

一旦连接，AI助手可以：

1. 搜索组件：

   User: "How do I use the Table component with sorting?"
   Agent: [calls cloudscape_search_docs("table sorting")]

1. 阅读具体文档：

   Agent: [calls cloudscape_read_doc("docs/components/table/sorting.md")]

项目结构

cloudscape-docs-mcp/
├── server.py          # MCP server with search/read tools
├── ingest.py          # Documentation indexing script
├── pyproject.toml     # Project dependencies
├── docs/              # Documentation files (partially curated)
│   ├── components/    # Component documentation
│   ├── foundations/   # Design foundations
│   └── genai_patterns/# GenAI UI patterns
└── data/              # Generated vector database (gitignored)
    └── lancedb/

配置

中的关键设置 server.py 和 ingest.py:

发展

# Install dev dependencies
uv sync --group dev

# Run with MCP inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/cloudscape_docs run server.py
# Alternatively, use mcp cli to launch the server
mcp dev server.py

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢

• AWS Cloudscape设计系统
• 模型上下文协议
• 阿里巴巴GTE多语言)
• LanceDB