Claude IPC MCP

Instructions

Implementation Reference

• src/claude_ipc_server.py:776-837 (handler)

  Core implementation of the 'rename' action in the MessageBroker class's _process_request method. Performs instance ID renaming, including validation, queue migration, name forwarding setup, rate limiting (once per hour), session updates, and broadcasts a notification to other instances.
  elif action == "rename": # Get validated instance_id from session old_id = request.get("old_id") # This will be overridden by session validation new_id = request["new_id"] # Validate new_id format if not self._validate_instance_id(new_id): return {"status": "error", "message": "Invalid new instance ID format"} # The old_id should match the session's instance_id (enforced by _process_request) # Check if old instance exists if old_id not in self.instances: return {"status": "error", "message": f"Instance {old_id} not found"} if new_id in self.instances: return {"status": "error", "message": f"Instance {new_id} already exists"} # Check rate limit (1 hour) now = datetime.now() if old_id in self.last_rename: time_since_last = (now - self.last_rename[old_id]).total_seconds() if time_since_last < 3600: # 1 hour in seconds minutes_left = int((3600 - time_since_last) / 60) return {"status": "error", "message": f"Rate limit: can rename again in {minutes_left} minutes"} # Move the queue if old_id in self.queues: self.queues[new_id] = self.queues.pop(old_id) else: self.queues[new_id] = [] # Update instance record self.instances[new_id] = self.instances.pop(old_id) # Set up name forwarding self.name_history[old_id] = (new_id, now) # Update rate limit tracking self.last_rename[new_id] = now if old_id in self.last_rename: del self.last_rename[old_id] # Update session mapping if old_id in self.instance_sessions: session_token = self.instance_sessions.pop(old_id) self.instance_sessions[new_id] = session_token # Update session info if session_token in self.sessions: self.sessions[session_token]["instance_id"] = new_id # Broadcast rename notification for instance_id in self.queues: if instance_id != new_id: notification = { "from": "system", "to": instance_id, "timestamp": now.isoformat(), "message": {"content": f"📝 {old_id} renamed to {new_id}"} } self.queues[instance_id].append(notification) return {"status": "ok", "message": f"Renamed {old_id} to {new_id}"}
• src/claude_ipc_server.py:1243-1258 (handler)

  MCP tool handler for the 'rename' tool in @app.call_tool(). Checks registration session, sends 'rename' action request to the message broker via BrokerClient, updates local instance_id on success, and returns the broker response.
  elif name == "rename": if not current_session_token: return [TextContent(type="text", text="Error: Not registered. Please register first.")] response = BrokerClient.send_request({ "action": "rename", "old_id": arguments["old_id"], "new_id": arguments["new_id"], "session_token": current_session_token }) # Update stored instance_id if rename succeeded if response.get("status") == "ok": current_instance_id = arguments["new_id"] return [TextContent(type="text", text=json.dumps(response, indent=2))]
• src/claude_ipc_server.py:1046-1062 (registration)

  Registration of the 'rename' MCP tool in @app.list_tools(), including description and input schema definition requiring 'old_id' and 'new_id'.
  name="rename", description="Rename your instance ID (rate limited to once per hour)", inputSchema={ "type": "object", "properties": { "old_id": { "type": "string", "description": "Your current instance ID" }, "new_id": { "type": "string", "description": "The new instance ID you want" } }, "required": ["old_id", "new_id"] } ),
• src/claude_ipc_server.py:1046-1062 (schema)

  Input schema definition for the 'rename' tool, specifying object with required string properties 'old_id' and 'new_id'.
  name="rename", description="Rename your instance ID (rate limited to once per hour)", inputSchema={ "type": "object", "properties": { "old_id": { "type": "string", "description": "Your current instance ID" }, "new_id": { "type": "string", "description": "The new instance ID you want" } }, "required": ["old_id", "new_id"] } ),