vr-mcp

芊云全景 MCP 服务

芊云小助手 - 为全景项目提供智能服务的 Model Context Protocol 服务器

🌐 关于芊云全景

芊云全景是一个专业的全景内容创作和管理平台，致力于为用户提供便捷、高效的全景VR内容制作和分享服务。

• 🌍 官方网站：9kvr.cn
• 📱 移动端体验：

_{抖音小程序                      微信小程序}

📖 项目简介

芊云全景 MCP (Model Context Protocol) 是一个为全景项目提供智能服务的协议服务器，通过 MCP 协议让 AI 助手能够访问全景平台的数据和功能，帮助用户更高效地管理和使用全景内容。

✨ 核心功能

1. 作品管理

• 📋 查看和管理用户的全景作品列表
• 🔍 支持分页、关键词搜索和多维度筛选
• 📊 获取作品详细信息和场景列表
• ✏️ 更新作品基本信息（名称、描述、封面等）
• 🔗 生成作品播放链接和编辑链接

2. 素材管理

• 🎬 查看和管理用户的素材库
• 📝 修改素材信息（名称、描述等）
• 📤 上传媒体素材到素材库
• 🔗 获取素材下载链接
• 🗑️ 删除素材（移入回收站）

3. 场景管理

• 🎥 获取作品的所有场景列表
• 📋 查看场景详细信息

4. 音乐管理

• 🎵 获取系统音乐库列表
• 🔍 搜索音乐素材
• 🎶 为作品设置背景音乐

5. 语音管理

• 🗣️ 获取场景的 AI 语音讲解列表
• ➕ 为场景添加 AI 语音讲解
• ✏️ 更新语音讲解配置
• 🗑️ 删除语音讲解

6. 热点管理

• 🔘 获取场景的热点列表
• ➕ 创建各种类型的热点（图片、视频、音频、文字、链接等）
• ✏️ 更新热点配置
• 🗑️ 删除热点

7. 评分系统

• 📊 获取作品的综合评分（满分100分）
• 💡 提供详细的优化建议
• 🔗 生成编辑链接，引导用户完善作品
• 📈 评分标准：背景音乐、视角信息、热点、详细介绍、AI语音讲解、LBS位置信息

8. 开发指导

• 📱 小程序开发指导（抖音、微信、快手）
• 🌐 网页接入全景指导
• 🔧 现有项目接入全景指导
• 💻 提供代码示例和最佳实践

9. 信息查询

• 📅 获取全局上下文信息（当前时间、时间理解规范等）
• 📦 获取版本信息和开发者信息

🚀 快速开始

安装

通过 npm 安装：

npm install -g vr-mcp

或通过 yarn 安装：

yarn global add vr-mcp

🔧 在 AI 编辑器中配置使用

Cursor 配置

在 Cursor 中，打开设置并找到 MCP 服务器配置，添加以下配置：

{
  "mcpServers": {
    "vr-mcp": {
      "command": "vr-mcp",
      "env": {
        "uid": "您的uid",
        "token": "您的token"
      }
    }
  }
}

提示：将 uid 和 token 替换为你的实际用户ID和认证令牌。

📌 获取方式：访问 MCP 工作台 获取你的 uid 和 token。

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加：

{
  "mcpServers": {
    "vr-mcp": {
      "command": "vr-mcp",
      "env": {
        "uid": "您的uid",
        "token": "您的token"
      }
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

📌 获取方式：访问 MCP 工作台 获取你的 uid 和 token。

其他支持 MCP 的编辑器

对于其他支持 MCP 协议的 AI 编辑器，配置方式类似：

• 命令：vr-mcp 或 npx vr-mcp
• 环境变量：
  • uid：用户ID（必填）
  • token：认证令牌（必填）

📌 获取方式：访问 MCP 工作台 获取你的 uid 和 token。

配置完成后，重启编辑器即可使用。AI 助手将能够访问全景平台的功能，帮助你管理和操作全景内容。

📚 使用示例

获取作品列表

// 通过 MCP 客户端调用
{
  "tool": "list_works",
  "arguments": {
    "limit": 10,
    "page": 1,
    "keyword": "全景"
  }
}

获取作品评分

{
  "tool": "get_work_score",
  "arguments": {
    "work_id": "12345"
  }
}

添加背景音乐

{
  "tool": "set_work_music",
  "arguments": {
    "work_id": 12345,
    "music_id": 67890
  }
}

类型检查

npm run type-check
# 或
yarn type-check

📋 可用工具列表

作品相关

• list_works - 获取作品列表
• get_work_info - 获取作品详情
• get_work_scenes - 获取作品场景列表
• update_work_info - 更新作品信息

素材相关

• list_media - 获取素材列表
• get_media_info - 获取素材详情
• update_media_info - 更新素材信息
• upload_media - 上传素材
• download_media - 获取素材下载链接
• delete_media - 删除素材

音乐相关

• list_music - 获取音乐列表
• search_music - 搜索音乐
• set_work_music - 设置作品背景音乐
• get_work_music - 获取作品背景音乐

语音相关

• list_scene_voices - 获取场景语音列表
• add_scene_voice - 添加场景语音
• update_scene_voice - 更新场景语音
• delete_scene_voice - 删除场景语音

热点相关

• list_scene_hotspots - 获取场景热点列表
• create_hotspot - 创建热点
• update_hotspot - 更新热点
• delete_hotspot - 删除热点

评分相关

• get_work_score - 获取作品评分和优化建议

开发指导相关

• get_miniprogram_guide - 获取小程序开发指导
• get_web_guide - 获取网页接入指导
• get_integration_guide - 获取项目接入指导

信息查询相关

• get_global_context - 获取全局上下文信息
• get_version - 获取版本信息

🔐 环境变量

变量名	说明	必填	默认值
uid	用户ID	是	-
token	认证 Token	是	-

注意：API 服务器地址（https://web.9kvr.cn）是固定的内置值，无需配置。

📌 获取 uid 和 token：访问 MCP 工作台 获取你的凭证信息。

📖 详细文档

• 开发文档 - 完整的 API 说明和使用指南
• 构建说明 - 代码构建、混淆和发布流程

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🙏 致谢

感谢使用芊云全景 MCP 服务！

芊云小助手 - 让 AI 更好地理解和管理全景内容 🎉