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 | 查看谁已连接 |
设置
先决条件
- Node.js>=18
- RP1开发人员帐户(dev.rp1.com)
安装
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.jsGemini 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 templateMCP资源
服务器向AI代理公开这些资源:
| URI | 描述 |
|---|---|
rp1://dev-guide | 开发人员工作流程文档 |
rp1://fabric-schema | 结构配置JSON模式 |
rp1://nso-schema | NSO定义JSON模式 |
rp1://object-types | 对象类型层次结构引用 |
相关项目
发展
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版获得许可。
