BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:268-285 (handler)

  The handler function for the 'get_object_info' tool. It connects to Blender via get_blender_connection(), sends a 'get_object_info' command with the object_name parameter, and returns the JSON-formatted result or an error message.

  @telemetry_tool("get_object_info")
  @mcp.tool()
  def get_object_info(ctx: Context, object_name: str) -> str:
      """
      Get detailed information about a specific object in the Blender scene.
      
      Parameters:
      - object_name: The name of the object to get information about
      """
      try:
          blender = get_blender_connection()
          result = blender.send_command("get_object_info", {"name": object_name})
          
          # Just return the JSON representation of what Blender sent us
          return json.dumps(result, indent=2)
      except Exception as e:
          logger.error(f"Error getting object info from Blender: {str(e)}")
          return f"Error getting object info: {str(e)}"

• src/blender_mcp/server.py:268-269 (registration)

  The @mcp.tool() decorator registers the get_object_info function as an MCP tool. The @telemetry_tool decorator adds telemetry tracking.

  @telemetry_tool("get_object_info")
  @mcp.tool()

• src/blender_mcp/server.py:271-276 (schema)

  The docstring provides the tool description and parameter schema: object_name (str). The function signature also defines the input/output types.

  """
  Get detailed information about a specific object in the Blender scene.
  
  Parameters:
  - object_name: The name of the object to get information about
  """