1. 服务概述一句话简介暴露Ramoira品牌模式规范作为工具和资源的MCP服务器让任何MCP兼容客户端都能生成、验证或推理Ramoira品牌模式。服务名称Ramoira MCP Server版本号当前稳定版本开发者/提供方ramoira协议类型MCP (Model Context Protocol)2. 核心功能该MCP服务提供的主要工具2.1 工具列表get_spec_overview模式格式的高层解释包括五个层次和关键概念建议从这里开始get_layer_spec(layer)获取特定层的完整字段定义支持五个层identity、narrative、voice、commercial、governanceget_valid_enums()获取所有受约束字段的有效枚举值及其字段路径get_example_schema()获取高质量示例模式Rolex案例展示良好填充的字段样式search_spec(query)在所有规范文档中进行关键词搜索2.2 资源列表ramoira://spec规范概览作为纯文本资源ramoira://enums有效枚举值作为JSON资源3. 使用场景该服务适合在以下情况下使用品牌模式生成为品牌创建符合Ramoira规范的结构化模式模式验证验证现有品牌模式是否符合Ramoira规范要求规范理解通过AI辅助理解Ramoira品牌模式的五个层次结构枚举值查询快速查找特定字段的有效枚举值示例参考参考高质量的品牌模式示例如Rolex进行学习外部LLM工作流任何需要生成或验证模式的代理都可以连接此服务器而无需在提示中内联规范4. 接入方式4.1 服务端点该服务支持以下传输方式stdio传输默认方式适用于本地客户端HTTP传输可通过修改代码启用用于公共HTTP托管4.2 认证与权限该服务为开放服务无需认证即可使用。4.3 数据格式服务使用以下数据格式进行通信通信协议MCP JSON-RPC传输方式stdio默认或HTTP可选数据序列化JSON格式资源格式纯文本和JSON4.4 服务器配置在Claude Desktop中配置添加到~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 或%APPDATA%\Claude\claude_desktop_config.json(Windows){ mcpServers: { ramoira: { command: npx, args: [ramoira/mcp] } } }在Cursor / VS Code中配置添加到MCP设置{ ramoira: { command: npx, args: [ramoira/mcp] } }5. 接口定义该服务提供以下主要工具接口工具名称描述参数get_spec_overview获取规范概览无get_layer_spec获取特定层规范layer: identity | narrative | voice | commercial | governanceget_valid_enums获取所有有效枚举值无get_example_schema获取示例模式无search_spec搜索规范文档query: string6. 快速开始6.1 环境要求Node.jsv16或更高版本npm/npx用于安装和运行MCP兼容客户端Claude Desktop、Cursor、Windsurf等6.2 安装方式# 全局安装 npm install -g ramoira/mcp # 或直接运行无需安装 npx ramoira/mcp6.3 使用示例# 在Claude中使用 Ramoira MCP Server Can you give me an overview of the Ramoira brand schema? Ramoira MCP Server Get the identity layer specification Ramoira MCP Server Show me the example schema for Rolex Ramoira MCP Server Search for brand voice in the specification6.4 开发模式# 克隆仓库 git clone https://github.com/ramoira/mcp cd mcp # 安装依赖 npm install # 开发模式运行通过tsx无需构建 npm run dev # 构建到dist/ npm run build7. 注意事项stdio传输当前服务器使用stdio传输适用于本地客户端HTTP托管如需公共HTTP托管需要修改src/server.ts中的传输方式离线支持CLI的生成器在本地镜像了相同的工具集ramoira init可离线工作外部工作流此服务器用于外部LLM工作流任何需要生成或验证模式的代理都可以连接规范来源ramoira/brand-schema-spec是规范的真相来源许可证该项目许可证信息未在仓库中明确标注系统架构ramoira/brand-schema-spec ← 规范真相来源 │ ▼ ramoira/mcp ← 本包 将规范作为MCP工具提供服务使任何LLM都能使用它 │ ├─► Claude Desktop / Cursor / 任何MCP客户端 │ 任何LLM会话都可以按需查找规范 │ └─► ramoira/cli内部使用 ramoira init在本地使用相同的工具集 以便在模式生成期间为Claude提供规范访问品牌模式五个层次identity品牌身份层narrative品牌叙事层voice品牌声音层commercial商业层governance治理层相关资源GitHub仓库ramoira/mcpnpm包ramoira/mcp
