空间互联网开发服务器

RP1空间互联网开发者工作流的基础设施层,用于创建和管理空间结构、服务器配置及网络服务对象(NSOs)。

  • by jl-codes
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jl-codes/rp1-dev-mcp

使用说明

rp1开发mcp

MCP服务器 RP1空间互联网开发人员工作流程 --创建空间结构,连接到RP1的通用空间结构,管理服务器,配置网络服务对象(NSO)。

这是 基础设施层 基于RP1构建。对于 内容编辑 (场景、对象、3D模型),使用 歧管MCP.

什么是RP1?

RP1 是一个开放的空间互联网平台——一个用于构建、连接和穿越实时3D体验的元宇宙浏览器和生态系统。开发人员可以自行托管空间服务器,创建持久的3D环境(空间结构),并将其连接到RP1的通用空间结构,使任何人都可以发现它们。

工具

服务器管理(4)

工具 目的
list_profiles 列出已配置的连接配置文件
server_status 检查服务器运行状况、版本和功能
server_config 查看服务器配置
server_logs 检索最近的服务器日志

结构生命周期(6)

工具 目的
create_fabric 创建新的空间结构(持久3D环境)
list_fabrics 列出服务器上的所有结构
get_fabric 获取结构详细信息、配置和附件状态
configure_fabric 更新结构设置
delete_fabric 移除织物
export_fabric 导出为MSF文件

连接/拆卸(5)

工具 目的
attach_fabric 将织物连接到RP1的通用空间织物上
detach_fabric 从通用织物上断开连接
attachment_status 检查附件状态和位置
list_attachments 列出您的所有附着点
move_attachment 重新定位附件

网络服务对象(5)

工具 目的
create_nso 创建NSO(人工智能、支付、物联网、多人游戏等)
list_nsos 列出结构中的NSO
get_nso 获取NSO详细信息和端点信息
update_nso 更新NSO配置
delete_nso 删除NSO

开发人员工作流程(5)

工具 目的
scaffold_project 从模板生成项目
validate_fabric 部署前验证配置
deploy_fabric 将结构部署到服务器
get_dev_info 开发人员帐户信息
generate_nso_template 生成NSO样板

监控(3)

工具 目的
ping 快速连接检查
fabric_health 详细的健康检查
list_connected_users 查看谁已连接

设置

先决条件

安装

git clone https://github.com/jl-codes/rp1-dev-mcp.git
cd rp1-dev-mcp
npm install
npm run build

配置

创建 ~/.config/rp1-dev-mcp/config.json:

{
  "default": {
    "serverUrl": "https://your-server.example.com",
    "devApiUrl": "https://dev.rp1.com",
    "apiKey": "your-api-key",
    "fabricUrl": "https://your-server.example.com/fabric/fabric.msf"
  }
}
字段 描述
serverUrl 必修的。 RP1空间结构服务器的URL
devApiUrl RP1开发者API URL(默认值: https://dev.rp1.com)
apiKey 用于身份验证的API密钥
fabricUrl 您织物的MSF URL

可以定义多个配置文件(例如。, "default", "staging", "production")并通过每次通话进行选择 profile 参数。

添加到MCP客户端

先建造(npm run build),然后注册:

临床(VS代码):

添加到MCP设置中:

{
  "mcpServers": {
    "rp1-dev": {
      "command": "node",
      "args": ["/absolute/path/to/rp1-dev-mcp/dist/index.js"]
    }
  }
}

克劳德代码:

claude mcp add --scope user rp1-dev -- node /absolute/path/to/rp1-dev-mcp/dist/index.js

食品法典:

codex mcp add rp1-dev -- node /absolute/path/to/rp1-dev-mcp/dist/index.js

Gemini CLI:

gemini mcp add -s user rp1-dev node /absolute/path/to/rp1-dev-mcp/dist/index.js

使用示例

> List my RP1 connection profiles
> Check server status
> Create a standalone spatial fabric called "My World"
> Attach it to RP1's universal spatial fabric
> Create an AI agent NSO in my fabric
> Scaffold a new full-stack RP1 project
> Generate a commerce NSO template

MCP资源

服务器向AI代理公开这些资源:

URI 描述
rp1://dev-guide 开发人员工作流程文档
rp1://fabric-schema 结构配置JSON模式
rp1://nso-schema NSO定义JSON模式
rp1://object-types 对象类型层次结构引用

相关项目

  • 歧管MCP --用于编辑空间结构场景(对象、资源、动作)的MCP服务器
  • 歧管 --基于Web的可视化地图浏览器
  • RP1开发者中心 --注册并开始在RP1上构建

发展

npm run dev          # TypeScript watch mode
npm run build        # Build for production
npm run inspect      # Test with MCP Inspector

项目结构

src/
  index.ts              # MCP server entry point
  config.ts             # Connection profile loader
  types.ts              # Shared TypeScript types
  output.ts             # Pagination helpers
  agent-guide.md        # Workflow docs served to MCP clients
  client/
    rp1-client.ts       # RP1 developer API client
  tools/
    index.ts            # Tool registry
    schemas.ts          # Zod input schemas
    errors.ts           # Error serialization
    server.ts           # Server management tools
    fabric.ts           # Fabric CRUD tools
    attach.ts           # Attach/detach tools
    nso.ts              # NSO management tools
    scaffold.ts         # Scaffolding & workflow tools
    monitoring.ts       # Health & monitoring tools

许可证

根据Apache许可证2.0版授权。看 许可证.

贡献

欢迎投稿!通过提交pull请求,您同意您的贡献将根据Apache许可证2.0版获得许可。