使用说明
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.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 |
对象类型层次结构引用 |
相关项目
发展
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版获得许可。