rp1-dev-mcp

rp1-dev-mcp

MCP server for the RP1 spatial internet developer workflow — create spatial fabrics, attach to RP1's universal spatial fabric, manage servers, and configure Network Service Objects (NSOs).

This is the infrastructure layer for building on RP1. For content editing (scenes, objects, 3D models), use ManifolderMCP.

What is RP1?

RP1 is the open spatial internet platform — a metaverse browser and ecosystem for building, connecting, and traversing real-time 3D experiences. Developers can self-host spatial servers, create persistent 3D environments (spatial fabrics), and attach them to RP1's universal spatial fabric to make them discoverable by anyone.

Tools

Server Management (4)

Fabric Lifecycle (6)

Attach / Detach (5)

Network Service Objects (5)

Developer Workflow (5)

Monitoring (3)

Setup

Prerequisites

• Node.js >= 18
• An RP1 developer account (dev.rp1.com)

Install

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

Configure

Create ~/.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"
  }
}

Multiple profiles can be defined (e.g., "default", "staging", "production") and selected per-call via the profile parameter.

Add to MCP Client

Build first (npm run build), then register:

Cline (VS Code):

Add to your MCP settings:

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

Claude Code:

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

Codex:

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

Usage Examples

> 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 Resources

The server exposes these resources for AI agents:

Related Projects

• ManifolderMCP — MCP server for editing spatial fabric scenes (objects, resources, actions)
• Manifolder — Web-based visual map explorer
• RP1 Developer Center — Register and get started building on RP1

Development

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

Project Structure

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

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Contributing

Contributions are welcome! By submitting a pull request, you agree that your contribution will be licensed under the Apache License, Version 2.0.